VSCode中node -v报错90%因Node未加入系统PATH：Windows需在系统环境变量PATH添加C:\Program Files\nodejs\并重启VSCode；macOS/Linux须从终端执行code .启动以继承shell环境；验证必须在VSCode内置终端运行node -v有输出。

VSCode 里 node -v 报错，90% 是系统级 Node.js 没装进 PATH，不是 VSCode 配置问题，更不是插件能解决的。

终端能跑 node -v，但 VSCode 内置终端报 “command not found”

这说明 VSCode 启动时没读到 shell 的环境变量，Windows 和 macOS/Linux 表现不同，但根因一致：PATH 没继承。

• Windows 用户：打开“系统属性 → 高级 → 环境变量”，在“系统变量”的 PATH 里手动加一行 C:\Program Files\nodejs\（LTS 安装默认路径），必须重启所有已打开的 VSCode 实例，只重启终端不够
• macOS/Linux 用户：别从 Dock 或 Spotlight 启动 VSCode；先在终端执行 source ~/.zshrc（或对应 shell 配置），再运行 code . 启动编辑器
• 验证方式：在 VSCode 内置终端（Ctrl + `）里直接敲 node -v 和 npm -v，有输出才算真正通过

launch.json 中 program 字段总提示 “Cannot find module”

这不是路径写错了，是 VSCode 根本没把 ${workspaceFolder} 解析成真实路径，或者指向了一个不存在的文件。

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

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

下载

• program 必须是完整、可访问的 JS 文件路径，推荐写法："${workspaceFolder}/app.js" —— ${workspaceFolder} 是变量，不能省略，也不能写成 ./app.js 或 app.js
• 确保你是在“文件 → 打开文件夹”模式下打开项目，而不是只打开单个 .js 文件；否则 ${workspaceFolder} 为空，路径拼接失败
• 如果用 TypeScript，program 不能指向 .ts 源码；要么编译后填 "${workspaceFolder}/dist/index.js"，要么改用 runtimeExecutable: "npx" + runtimeArgs: ["ts-node", "src/index.ts"]

调试时断点灰掉、F5 按下没反应

断点变空心圆，代表 VSCode 调试器压根没加载目标文件——大概率是 type 或 request 值写错，或 Node 版本太低。

• "type": "node" 必须全小写，写成 "Node" 或 "NODE" 会导致调试器跳过该配置
• "request": "launch" 对应本地直接运行；若项目靠 npm start 启动，得改成 "request": "launch" + "runtimeExecutable": "npm" + "runtimeArgs": ["start"]
• Node.js 版本低于 v8.0 不支持 --inspect 协议，VSCode 调试器会静默失败；执行 node -v 确认 ≥ 8.0，不满足就升级

最容易被忽略的一点：VSCode 的调试器（pwa-node）不会自动帮你装依赖、不会读取项目 node_modules、也不会替你编译 TS；它只负责启动一个进程并注入调试协议。所有前置动作——安装 Node、配置 PATH、构建代码、生成 source map——都得你手动完成且验证到位，缺一不可。