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——都得你手动完成且验证到位，缺一不可。
