能直接在VSCode终端敲node -v看到版本号才算Node环境就位；否则运行、调试、npm install均失败，根源几乎全是PATH未生效，Windows需重装时勾选Add to PATH并彻底重启VSCode，macOS/Linux需确保shell配置正确加载。
能直接在 VSCode 终端里敲 node -v 并看到版本号，才算 Node 环境真正就位；否则所有后续操作（运行、调试、npm install）都会失败，根源几乎全是 PATH 没生效。
node -v 在系统终端成功，但在 VSCode 里报错
这不是 VSCode 的问题，而是它没继承你当前 shell 的环境变量。Windows 用户常见于安装时漏勾 “Add to PATH”，macOS/Linux 用户则多因 shell 配置未加载（比如 ~/.zshrc 里没 source ~/.nvm/nvm.sh）。
- Windows：重装 Node.js LTS 版，安装界面务必勾选 Add to PATH；装完后必须彻底退出 VSCode（任务管理器确认
Code.exe进程不存在），再重新打开 - macOS/Linux：在终端执行
which node，确认路径合理（如/usr/local/bin/node或~/.nvm/versions/node/v20.15.0/bin/node）；若路径异常，检查 shell 配置文件是否已加载 nvm 或 homebrew 路径 - 别依赖 VSCode 内置终端“重启终端”——它不刷新环境变量；必须关掉整个 VSCode 进程再开
npm -v 成功与否决定调试器能否启动
npm -v 报错或无输出，说明 npm 没进 PATH，或全局路径被改过但没同步到系统变量。VSCode 的 Node.js 调试器底层调用 npm 启动脚本，不是可选项。
- 执行
npm config get prefix，看输出路径是否合理（默认是C:\Users\xxx\AppData\Roaming\npm或~/.npm-global） - 如果改过 prefix（比如设为
D:\npm-global），必须把这个路径手动加进系统PATH，然后彻底重启 VSCode - 国内用户建议同步配镜像：
npm config set registry https://registry.npmmirror.com，避免npm install卡死影响验证
launch.json 中 program 字段写错导致 F5 失败
VSCode 自动生成的 launch.json 默认是 "program": "${workspaceFolder}/index.js"，但你可能正在编辑 server.js 或 app.js —— 调试器找不到入口文件，就会静默退出或报 Cannot find module。
- 最稳妥做法：把
"program"改成"${file}"，这样 F5 总是运行当前打开的 JS 文件，不用来回改配置 - 如果项目有固定入口（如
index.js），确保工作区是用“文件 → 打开文件夹”打开的整个项目根目录，而不是只打开单个文件 - 调试前务必保存文件（
Ctrl+S），VSCode 不会自动保存未保存的内容，断点设了也无效
最容易被忽略的是：VSCode 终端是否真的读到了你 shell 里生效的 npm 配置。哪怕你在 iTerm 里能用 nodemon，VSCode 里仍提示 command not found，大概率是它启动时没 source 你的 shell 配置文件——这种问题只能靠重启 VSCode 或手动在终端里执行 source ~/.zshrc 临时绕过。
