vscode终端node -v报command not found，根本原因是未加载shell配置导致path缺失：macos/linux需设terminal.integrated.shellargs为["-l"]并彻底重启，windows应检查系统环境变量中是否含c:program files odejs并重装lts版确保勾选add to path。
VSCode终端里node -v报command not found，先确认PATH是否真生效
这不是VSCode设置没调对，而是它根本没拿到你shell里定义的PATH。macOS/Linux下从Dock或Spotlight启动VSCode，进程不会读~/.zshrc；Windows则常因Node安装时漏选Add to PATH，导致C:Program Files
odejs压根不在系统Path里。
验证方式只有一种：在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）。
- Windows路径用正斜杠
/或双反斜杠\均可，但不能混用单反斜杠 -
${env:PATH}必须保留，否则会丢掉系统原有PATH，导致npm、git等命令失效 - 改完保存后，必须重启VSCode（不是重载窗口），否则新PATH不加载
调试器runtimeExecutable和终端PATH是两套逻辑，别指望自动同步
即使node -v在终端里跑通了，launch.json里仍可能报Cannot find runtime 'node'。因为调试器启动的进程和终端完全隔离，它不继承terminal.integrated.env.*里的PATH。
在.vscode/launch.json中，每个configuration下加runtimeExecutable字段，例如：
{
"configurations": [{
"type": "node",
"request": "launch",
"name": "Launch Program",
"runtimeExecutable": "/Users/you/.nvm/versions/node/v18.20.4/bin/node",
"program": "${file}"
}]
}
-
runtimeExecutable必须指向具体可执行文件，不能只写node命令名 - 如果你用
nvm，别指望${env:NVM_BIN}自动生效——要么把node路径写死，要么在终端里先运行nvm use 18.20.4再按F5 - 右下角状态栏必须显示“Node.js”调试器，而不是“JavaScript Debug”；后者用于浏览器端，对纯Node无效
npm全局模块找不到？关键是NODE_PATH和PATH都要配对
npm install -g express成功但终端里敲express报“不是内部或外部命令”，问题出在npm prefix路径没加入系统PATH，或者NODE_PATH没设对。
先查当前设置：npm config get prefix和npm config get cache，确认是否指向你可控的路径（如D:
odejs
ode_global）。修改前缀和缓存路径必须用管理员权限运行CMD或PowerShell，否则写入失败但无提示。
- 改完后执行
npm config set registry https://registry.npmmirror.com换成国内镜像，避免超时 - 全局模块（如
express-generator）安装后，其可执行文件（如express）在prefix下的node_modules.bin目录，这个路径也必须加入Path - Windows系统变量里新建
NODE_PATH，值为D: odejs ode_global ode_modules；同时把D: odejs ode_global加进Path，否则require()找不到全局模块
nvm时，切换版本后VSCode主进程不会自动刷新PATH，而插件依赖的napi_build_version又必须和VSCode内置Electron的Node严格匹配——这点最容易被忽略。
