根本原因不是VSCode问题，而是其未继承系统PATH中的node路径；需先在系统终端验证node -v/npm -v成功，再通过重启VSCode、配置terminal.integrated.env.*或launch.json的runtimeExecutable显式指定Node绝对路径解决。
VSCode里node命令报“不是内部或外部命令”
根本不是VSCode的问题，而是它没继承到系统PATH里的node。你必须先在**系统终端（cmd/PowerShell/Terminal）**里运行node -v和npm -v，两个都成功输出版本号，才算Node安装到位。
常见卡点：
- Windows安装时没勾选 Add to PATH，或者装到了含空格/中文路径（比如
C:Program Files odejs） - 改完环境变量后没关掉所有VSCode窗口——它不会自动刷新PATH，必须完全重启
- 用nvm管理多版本时，
node在终端里是20.19.3，但VSCode启动时读的是旧shell配置，可能还是16.x
给单个项目指定Node路径：用terminal.integrated.env.*
全局改PATH风险高，容易影响其他项目；局部配置更安全，只对当前项目生效。
操作步骤：
- 在项目根目录建
.vscode/settings.json（不是用户设置，是工作区设置） - 写入对应系统的环境变量注入，例如Windows：
{
"terminal.integrated.env.windows": {
"PATH": "C:\dev\node-v20.19.3;${env:PATH}",
"NODE_PATH": "C:\dev\node-v20.19.3"
}
}
注意：C:\dev\node-v20.19.3是你解压后的Node目录，不是node.exe路径；${env:PATH}必须保留，否则会丢掉原有PATH
macOS/Linux同理，用terminal.integrated.env.linux或terminal.integrated.env.osx，路径填/opt/node-v20.19.3/bin
调试时runtimeExecutable不配等于白配
VSCode默认按PATH找node，但PATH顺序和你终端里看到的未必一致——尤其nvm、fnm、volta共存时，launch.json里不显式指定，断点大概率不命中，process.execPath打印出来也常是错的。
正确做法：
- 在项目根目录建
.vscode/launch.json -
runtimeExecutable字段必须填绝对路径，不能用node或~ - Windows示例：
"runtimeExecutable": "C:\dev\node-v20.19.3\node.exe" - macOS示例：
"runtimeExecutable": "/opt/node-v20.19.3/bin/node"
验证方式：在JS里加console.log(process.execPath)，对比调试器输出和runtimeExecutable是否完全一致
别信Code Runner，真跑脚本请用内置终端
Code Runner插件快捷键Ctrl+Alt+N看着方便，但它绕过package.json里的"type": "module"、"exports"等字段，直接调node index.js，ESM项目十有八九报Cannot use import statement outside a module。
可靠做法：
- 按
Ctrl+`唤出VSCode内置终端 - 手动执行
node index.js或npm start - 如果项目是ESM，确保
package.json里有"type": "module"，且文件扩展名是.mjs或.js（后者需配合type字段）
Code Runner只适合临时测单个.js片段，非模块化逻辑；正式开发中建议禁用，避免养成依赖黑盒执行的习惯
