VS Code本身不管理Node.js版本，报“command not found”是因启动时未加载shell的PATH；macOS/Linux应从终端执行code --no-sandbox .启动，Windows用nvm-windows后需Ctrl+Shift+P执行Terminal: Reload Shell Environment，或在设置中显式配置node.runtimePath。
VS Code 本身不管理 Node.js 版本，所谓“不兼容”几乎全是环境错配导致的——调试器用了一个 Node，插件用另一个，终端又继承了第三个。解决的关键不是升级或降级，而是让每个上下文明确使用你指定的那个 Node。
node -v 能跑，但 VS Code 报 command not found 怎么办
这不是插件问题，是 VS Code 启动时没读到 shell 的 PATH。尤其在用 nvm/nvm-windows 切换版本后，主进程会缓存旧环境。
- macOS/Linux：从终端执行
code --no-sandbox .启动 VS Code，确保加载当前 shell 的~/.zshrc或~/.bash_profile - Windows（nvm-windows）：每次
nvm use后，在 VS Code 中按Ctrl+Shift+P运行Terminal: Reload Shell Environment - 终极手段：在 VS Code 设置里搜
node.runtimePath，填入which node输出的绝对路径，比如/Users/xxx/.nvm/versions/node/v20.12.2/bin/node
launch.json 里 runtimeExecutable 设了还是报 Cannot find module './build/Release/xxx.node'
这是 ABI 不匹配的典型症状。原生模块（如 sqlite3、bcrypt）编译时绑定的是某个 napi_build_version，而 VS Code 插件主机（Extension Host）进程用的是内置 Electron 捆绑的 Node（比如 v22.4.0，napi_build_version=9），跟你系统里 node -v 显示的 v20.x（napi=8）根本对不上。
- 先确认：在插件输出通道或调试控制台中打印
process.versions.napi，看它到底是几 - 重编译原生模块时，必须带完整参数：
npm rebuild --napi-build-version=9 --runtime=electron --target=34.0.0 - 务必清空插件目录下的
node_modules/.pnpm和out/，否则旧二进制会被优先加载
VS Code 终端里 NODE_ENV=production node app.js 在 Windows 上失效
因为 cmd 和 PowerShell 不支持 POSIX 风格的环境变量前置写法。这不是 VS Code 的锅，是 shell 语法差异。
- 别硬改终端类型，统一用
cross-env：先npm install --save-dev cross-env - 在
package.jsonscripts 里写："start:prod": "cross-env NODE_ENV=production node app.js" - 在
launch.json中调用："runtimeExecutable": "cross-env"，"runtimeArgs": ["NODE_ENV=development", "node", "app.js"] - 注意：
cross-env@7要求 Node ≥10；若项目还在用 Node 8，得装cross-env@6
断点灰掉、F5 按下没反应，但终端能正常跑 npm start
大概率是 launch.json 的 request 类型和启动方式不匹配。VS Code 调试器不会自动解析 npm start 脚本里的逻辑，它只认你明确定义的执行链。
- 如果项目靠
npm start启动（比如 Express、Next.js），不要用"request": "launch"+"program"，该配成："request": "launch"+"runtimeExecutable": "npm"+"runtimeArgs": ["start"] - 如果要用 Attach 模式（比如服务已后台运行），确保目标进程已加
--inspect参数，且launch.json中"port"与之对应（默认9229） - 检查
launch.json里是否漏了"console": "integratedTerminal"—— 缺这个，某些输出可能被吞掉，让你误以为没跑起来
最易被忽略的一点：ABI 兼容性不是“Node 版本够新就行”，而是 process.versions.napi 必须和原生模块编译时声明的 napi_build_version 完全一致——差 1 都不行。
