VSCode终端找不到node命令，根本原因是启动时未加载shell配置（如~/.zshrc）或系统PATH未包含Node路径；需先执行node -v验证，再针对性修复macOS/Linux的login shell配置或Windows的系统环境变量，并确保重启VSCode生效。
VSCode终端找不到node命令，先确认PATH是否继承成功
根本不是VSCode设置问题，而是它启动时没加载你的shell配置（如~/.zshrc）或系统PATH压根没写入Node路径。macOS/Linux下从Dock或Spotlight启动VSCode，进程不会读~/.zshrc；Windows则常因安装时漏选Add to PATH，导致C:Program Files
odejs根本不在系统变量里。
验证方式只有一种：在VSCode内置终端（Ctrl + `）里直接执行node -v。没输出就别往下配launch.json或插件——所有后续操作都是空转。
- macOS/Linux：改完
~/.zshrc后，必须彻底退出所有VSCode窗口，再从终端执行code --no-sandbox .启动 - Windows：打开「系统属性 → 高级 → 环境变量」，检查「系统变量」的
Path中是否有C:Program Files odejs；有但无效，大概率是路径含空格、斜杠方向错，或被其他软件覆盖 - 更稳妥做法：卸载Node.js，重装LTS版，安装时务必勾选
Add to PATH，且路径避开中文和空格
terminal.integrated.env.*能绕过系统PATH限制
当你没权限改系统环境变量，或需要为单项目指定Node版本（比如用nvm管理多个版本），就得靠VSCode自己的环境变量注入机制。它不修改系统PATH，而是在终端启动时把指定路径“前置”进环境变量，优先级高于系统原有PATH。
- 全局生效（所有项目都用这个Node）：在VSCode设置中搜
Env，点开terminal.integrated.env.windows（macOS/Linux对应.linux或.osx），编辑settings.json：
{
"terminal.integrated.env.windows": {
"PATH": "C:/path/to/your/node;${env:PATH}",
"NODE_PATH": "C:/path/to/your/node"
}
}
.vscode/settings.json，内容同上。注意路径中的C:/path/to/your/node要替换成你实际解压或安装的node.exe所在目录（不是node_modules）/或双反斜杠\均可，但不能混用单反斜杠；${env:PATH}必须保留，否则会丢掉系统原有PATH，导致npm、git等命令失效
launch.json里的runtimeExecutable和终端PATH是两套逻辑
即使node -v在终端里跑通了，launch.json里仍可能报Cannot find runtime 'node'。因为调试器默认不走系统PATH，尤其当你用了nvm、fnm或volta。
- 检查项目下的
.vscode/launch.json，如果里面有"runtimeExecutable"字段，且路径写死了（比如指向~/.nvm/versions/node/v18.17.0/bin/node），那它就完全不依赖系统PATH - 推荐写法：
"runtimeExecutable": "${env:HOME}/.nvm/versions/node/v18.17.0/bin/node"（macOS/Linux）或"runtimeExecutable": "C:\Users\xxx\AppData\Roaming\nvm\v18.17.0\node.exe"（Windows） - 若用
npm start启动，可改用"type": "pwa-node"+"request": "launch"+"runtimeExecutable": "npm"+"runtimeArgs": ["start"]，再配合"envFile": "${workspaceFolder}/.env"注入变量
envFile和process.env不是一回事
VSCode的envFile只影响调试器启动时注入的环境变量，不影响运行时process.env读取——后者仍由dotenv或系统环境决定。
-
launch.json中加"envFile": "${workspaceFolder}/.env"，只会让调试器启动时把.env内容塞进子进程环境，对require('dotenv').config()无影响 - 如果代码里用了
dotenv，那.env文件仍需手动加载；VSCode的envFile只是多一层覆盖，不替代它 - 敏感变量（如
DB_PASSWORD）别放.env文件里提交到Git，应通过envFile在本地调试时注入，生产环境走系统环境变量
最易被忽略的是：runtimeExecutable路径是否真实存在，以及envFile是否被launch.json正确引用——这两处出错，process.env看起来有值，实际调试时却为空。
