根本原因是vscode启动时未加载shell配置文件导致path缺失；需设terminal.integrated.shellargs为["-l"]并彻底重启vscode，同时在launch.json和tasks.json中手动配置env字段补全path。

VSCode 本身不带 Node.js，必须先在系统里装好 node 和 npm，否则所有调试、运行、安装依赖都会失败——这不是 VSCode 设置问题，而是根本没 runtime。

node -v 在系统终端成功，但在 VSCode 终端报 command not found

这是最常见也最误导人的现象，本质是 VSCode 没读到你刚配好的 PATH。

• Windows 用户：重装 Node.js 时漏选了 “Add to PATH”，或手动加路径后没重启 VSCode 进程（仅关窗口不够，得在任务管理器里杀掉所有 Code.exe）
• macOS/Linux 用户：Node.js 装在 /usr/local/bin/node，但 shell 配置文件（如 ~/.zshrc）没执行 source ~/.zshrc，导致新终端没加载 PATH
• VSCode 内置终端启动时继承的是“启动它时”的环境变量快照，改完 PATH 后必须完全退出 VSCode 再重开，不能只重启终端
• 验证方式：关掉 VSCode → 打开全新系统终端 → 运行 which node（macOS/Linux）或 where node（Windows）→ 确认路径合理 → 再打开 VSCode，立刻在内置终端敲 node -v

launch.json 中 program 字段写死导致 F5 调试失败

VSCode 自动生成的 launch.json 默认设 "program": "${workspaceFolder}/index.js"，但你实际主文件可能是 app.js 或 server.js，一换文件就断。

用于自动切换项目中适合的node 版本

根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。

下载

• 单文件快速调试：直接用 "program": "${file}"，这样无论当前打开哪个 JS 文件，F5 都运行它
• 项目级稳定调试：明确指向入口文件，比如 "program": "${workspaceFolder}/app.js"，但务必确保该文件真实存在且路径无拼写错误
• 别动 "type": "node" 和 "request": "launch"，这两个是调试器识别协议的关键，改错会导致整个调试流程静默失效
• 调试前必须保存文件：Ctrl+S（Windows/Linux）或 Cmd+S（macOS），VSCode 不会自动保存未存档的修改

npm install -g 的命令在 VSCode 终端里找不到

比如装了 nodemon，系统终端能用，VSCode 里却提示 command not found，说明全局 bin 目录没进 PATH。

• 如果你执行过 npm config set prefix（例如改成 D: pm-global），就必须把对应路径（如 D: pm-global）加进系统环境变量 PATH，而不仅是用户变量
• Windows 上加完 PATH 后，必须彻底关闭并重开 VSCode；macOS/Linux 上建议在 VSCode 终端里先执行 source ~/.zshrc（或对应 shell 配置），再验证 which nodemon
• 验证是否生效：npm config get prefix 输出路径，再确认该路径下 bin 子目录是否存在可执行文件（如 nodemon.cmd 或 nodemon）
• 重装全局工具：npm install -g nodemon，不是升级，是重新安装到新 prefix 下

调试时断点不触发或提示 Cannot find runtime 'node'

表面是调试配置问题，根源往往还是 node 命令不可用，或 VSCode 调用了错误版本。

• Cannot find runtime 'node' 是硬性报错，100% 说明 VSCode 内置调试器根本找不到 node 可执行文件，优先查 node -v 是否真能在内置终端运行
• 多版本共存（如用 nvm 或 nvm-windows）时，VSCode 可能调用 PATH 里排第一但非你期望的版本，导致源码映射失败或 ES Module 解析异常
• 解决方案：在 launch.json 中显式指定 "runtimeExecutable"，例如 "runtimeExecutable": "/usr/local/bin/node"（macOS）或 "runtimeExecutable": "C:\Program Files\nodejs\node.exe"（Windows）
• 验证是否生效：在代码里加 console.log(process.execPath)，对比输出路径和 runtimeExecutable 是否一致

最容易被忽略的，是 VSCode 终端是否真的继承了 shell 里已生效的环境变量——哪怕你在终端里 echo $PATH 看到了正确路径，VSCode 启动时可能仍用的是旧快照。重启编辑器不是“试试看”，而是必要操作。