VSCode不提供Node运行环境，必须先在系统安装Node.js并正确配置PATH；安装时务必勾选“Add to PATH”，装完需重启所有终端和VSCode，再验证node -v/npm -v；调试失败多因项目未以文件夹形式打开或launch.json中program路径错误。
VSCode 本身不提供 Node 运行环境，你不需要、也不能在 VSCode 里“安装 Node”——必须先在系统层面装好 Node.js，再让 VSCode 正确找到它。
node -v 报错：'node' 不是内部或外部命令
这是最常卡住的一步，本质是 Windows 没把 node.exe 加进系统 PATH。
- 去
nodejs.org/download下载 LTS 版本的.msi安装包，**安装时务必勾选 “Add to PATH”** —— 跳过这步，99% 后续都白配 - 装完后，关掉所有已打开的 CMD/PowerShell/VSCode 窗口，新开一个 CMD，运行
node -v和npm -v；只有两者都有输出，才算真正装好 - 如果用
nvm-windows，装完还要手动执行nvm use <version>激活，否则node依然不可用 - 别信“VSCode 插件能装 Node”——
Node.js Extension Pack等插件现在已过时，装了反而可能干扰调试器
VSCode 终端里 node 正常，但 F5 调试报 “无法启动程序”
说明 launch.json 配置和项目结构没对齐，不是环境问题。
- 必须通过 文件 → 打开文件夹 打开整个项目根目录（含
package.json或入口文件），不能只打开单个.js文件 - 按
Ctrl+Shift+P输入Debug: Open Configuration，选Node.js，生成默认配置 - 检查
launch.json中的"program"字段：
– 默认是"${workspaceFolder}/index.js"，如果你主文件叫app.js，就得改成"${workspaceFolder}/app.js"
– 不要改"type": "node"和"request": "launch"，这两个是调试器识别关键 - 调试前务必按
Ctrl+S保存文件——VSCode 默认不自动保存，断点设在未保存的代码上会失效
npm install -g 的命令（如 nodemon）在 VSCode 终端里找不到
说明全局 bin 目录没进 PATH，VSCode 终端读不到。
- 如果执行过
npm config set prefix（比如改成D:\npm-global），就必须把这个新路径手动加进系统环境变量PATH - 加完后，**关闭并完全重启 VSCode**（不只是重启终端），否则它仍用旧环境变量
- 验证方式：在 VSCode 终端里运行
npm config get prefix，输出路径应和你加进PATH的一致；再试nodemon -v - 国内建议提前配镜像：
npm config set registry https://registry.npmmirror.com，避免npm install卡死
macOS/Linux 用户用 nvm 时 VSCode 找不到 node
不是 VSCode 问题，而是 shell 配置没被继承。
- 确认
source ~/.nvm/nvm.sh已写入~/.zshrc（或~/.bash_profile），且新终端能执行node -v - VSCode 内置终端有时不会自动加载 shell 配置；最直接办法是：在 VSCode 终端里手动运行
source ~/.zshrc，或干脆从终端启动 VSCode：code . - 不要依赖 GUI 方式启动 VSCode（比如双击图标），它往往不继承 shell 环境变量
真正的难点不在 VSCode 设置，而在于系统级环境变量是否生效、是否被正确继承。很多人反复重装插件或修改 settings.json，却漏掉了关掉 VSCode 再重开这一步——它缓存的是启动那一刻的 PATH，不是实时更新的。
