VSCode无法识别Node.js的根本原因是环境变量未正确继承或未安装：Windows需重装时勾选“Add toPATH”，macOS/Linux需确保which node路径已写入~/.zshrc；必须彻底重启VSCode，否则PATH修改无效。
VSCode 本身不自带 Node.js 运行时，必须独立安装 Node.js 并确保终端能正确识别 node 和 npm —— 否则所有后续 npm 安装、脚本运行、调试都会失败。
node -v 报 command not found？先确认 Node.js 是否真被系统识别
很多人双击安装完 Node.js，关掉安装向导就以为万事大吉，结果在 VSCode 终端里敲 node -v 直接报错。这不是 VSCode 的问题，而是系统 PATH 没生效。
- Windows：重装 Node.js 时务必勾选 “Add to PATH”，否则手动把 Node.js 安装目录（如
C:\Program Files\nodejs）加进系统环境变量的Path - macOS/Linux：若用 Homebrew 安装，检查
which node输出是否在~/.zshrc或~/.bash_profile中已导出 - VSCode 内置终端可能缓存旧 PATH：必须完全关闭所有 VSCode 窗口，再重新打开项目文件夹
npm install -g webpack 之后，VSCode 终端仍提示 command not found
根本原因不是安装失败，而是全局 bin 路径没进终端的 PATH 环境变量。VSCode 终端默认不加载 shell 的 login profile，尤其在 PowerShell 或 zsh 下更常见。
- 先在系统终端（非 VSCode）运行
npm config get prefix，得到全局路径（如 Windows 是C:\Users\{user}\AppData\Roaming\npm，macOS/Linux 通常是/usr/local或~/.npm-global） - 把这个路径下的
bin子目录（如C:\Users\{user}\AppData\Roaming\npm本身，或/usr/local/bin）加入系统 PATH - Windows：通过“系统属性 → 高级 → 环境变量”添加；macOS/Linux：在
~/.zshrc中追加export PATH="$(npm config get prefix)/bin:$PATH"，然后source ~/.zshrc - 改完后必须重启 VSCode —— 只关终端、只 reload window 都不行
VSCode tasks.json 里执行 npm run dev 失败，但终端里能跑通
VSCode 的 task 系统不走 shell alias，也不自动 source 你的 ~/.zshrc，它只读取原始 PATH。哪怕你在终端里能运行 webpack，tasks 里照样找不到命令。
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
立即学习“前端免费学习笔记（深入）”；
- 验证方式：在 VSCode 终端里执行
echo $PATH，对比系统终端输出，看是否缺失全局 bin 路径 - 最直接解法：在
tasks.json的env字段里显式补全 PATH，例如："env": {"PATH": "/usr/local/bin:/Users/xxx/.npm-global/bin:${env:PATH}"} - 或者统一用
shell类型 task，并指定完整路径："command": "/Users/xxx/.npm-global/bin/webpack"
npm 全局包装到 D 盘却还是占满 C 盘？关键在 prefix 和 cache 分开配
只改 prefix 不够，cache 默认还在 %APPDATA%（Windows）或 ~/.npm（macOS/Linux），长期使用照样撑爆系统盘。
- 执行两步配置：
npm config set prefix "D:\npm-global"+npm config set cache "D:\npm-cache" - 然后把
D:\npm-global加进系统 PATH（注意不是D:\npm-global\node_modules） - 验证是否生效：
npm root -g应返回D:\npm-global\node_modules，npm config get cache应指向你设的缓存路径 - 改完后重装工具：
npm install -g nodemon eslint webpack，它们的可执行文件才会真正落在 D 盘
最容易漏掉的是：VSCode 的 tasks 和 launch 都不继承 shell 的环境变量加载逻辑，PATH 必须显式、完整、且重启后生效 —— 少一个环节，command not found 就会反复出现。
