VSCode内置终端找不到node是因为启动时未加载shell初始化文件（如~/.zshrc）或Windows未将Node路径加入系统PATH；macOS/Linux需通过code .启动或重启VSCode，Windows需手动配置环境变量；调试时program须指向编译后的JS文件且启用sourceMaps，runtimeExecutable必须显式指定以避免多版本冲突。
VSCode 本身不“导入”Node环境，它只继承你系统里已配置好的 node 和 npm；如果终端能跑 node -v，但 VSCode 里报 command not found，说明环境变量没传进来——这不是配置问题，是启动方式或 PATH 加载逻辑没对上。
为什么 VSCode 内置终端找不到 node
根本不是插件或设置缺失，而是 VSCode 启动时没加载 shell 的初始化文件（比如 ~/.zshrc 或 ~/.bash_profile）。macOS/Linux 用户从 Dock 或 Spotlight 启动 VSCode，它用的是干净的 PATH，不读你的 shell 配置；Windows 用户则大概率是安装 Node.js 时没勾选 Add to PATH。
- 验证方式唯一：在 VSCode 内置终端（
Ctrl + `）里执行node -v，没输出就别往下配 - macOS/Linux：改完
~/.zshrc后必须重启 VSCode，或直接在终端运行code .启动 - Windows：打开“系统属性 → 高级 → 环境变量”，把
C:Program Files odejs加进“系统变量”的PATH，再重启 VSCode
launch.json 中 program 字段写什么才有效
program 必须指向一个真实存在的、可被 node 直接执行的 JS 文件路径，不能是 TypeScript 源码、JSX 或未编译产物。默认生成的 "${file}" 只适合单文件调试，换文件就得手动改，容易出错。
- 项目有固定入口（如
index.js），建议写死："program": "${workspaceFolder}/index.js" - 调试前务必先保存文件——VSCode 不会自动保存未修改的文件，断点设在未保存内容上必然不命中
- 如果是 TypeScript 项目，
program必须指向编译后的.js文件，且tsconfig.json中需启用"sourceMaps": true，.js.map和.js必须同目录
runtimeExecutable 显式指定才能避开多版本冲突
如果你用 nvm、fnm 或 volta 管理 Node 版本，VSCode 调试器默认不识别切换逻辑，可能调用旧版本导致 import 报错、断点失效或 process.execPath 和预期不符。
- 查当前终端用的 node 路径：
which node（macOS/Linux）或where node（Windows） - 在
.vscode/launch.json的 configuration 里加一行："runtimeExecutable": "/usr/local/bin/node"（macOS/Linux）或"runtimeExecutable": "C:\Program Files\nodejs\node.exe"（Windows） - 加完后，在代码里写
console.log(process.execPath)，对比输出是否和runtimeExecutable一致
最容易被忽略的是：VSCode 的调试器和终端共享 PATH，但不共享 shell 的 alias、函数或 nvm 的当前版本状态；哪怕你在终端里 nvm use 20 切好了，VSCode 启动时还是按 PATH 顺序找第一个 node——所以显式指定 runtimeExecutable 不是可选项，是稳定调试的底线操作。
