VSCode终端报“node不是内部或外部命令”90%是因未继承系统PATH，而非Node未安装；需先在原生终端验证node -v/npm -v，再启用登录shell（macOS/Linux设terminal.integrated.shellArgs为["-l"]）或改用PowerShell启动VSCode，Windows用户还需手动补PATH或使用nvm use激活版本。
VSCode终端报node不是内部或外部命令，**90%的情况不是Node没装，而是VSCode根本没拿到系统PATH**——它启动的是一个“裸壳”终端，跳过了你的~/.zshrc、PATH设置或Windows用户环境变量。
先确认是不是系统级问题
别急着改VSCode设置。打开系统原生终端（CMD/PowerShell/Terminal/iTerm），运行：
-
where node（Windows）或which node（macOS/Linux）——有输出才说明Node真装对了 -
node -v和npm -v都能返回版本号，才算通过基础验证 - 如果这一步就失败：重装Node.js，Windows务必勾选
Add to PATH；macOS用Homebrew装完要重启终端；Linux手动安装的得自己加export PATH到~/.bashrc或~/.zshrc
VSCode终端PATH比系统终端短？启用登录shell
在VSCode集成终端里运行echo $PATH（macOS/Linux）或echo %PATH%（Windows），复制结果，再跟系统终端里同一命令的输出逐行对比。缺了/opt/homebrew/bin、$HOME/.nvm/versions/node/v18.18.2/bin或%APPDATA%
pm这类路径，就是确诊了。
- macOS/Linux：打开VSCode设置（
Cmd + ,），搜terminal.integrated.shellArgs，设为["-l"]（小写L，不是数字1） - 改完后必须关闭所有已打开的集成终端面板（不只是关标签页），再按
Ctrl + `新建一个 - 如果仍不生效，检查
~/.zshrc开头是否有[[ -n $ZSH_EVAL_CONTEXT ]] && return——它会让文件提前退出，后面所有export PATH都白写
Windows用户别信开始菜单启动的VSCode
从桌面图标或开始菜单双击打开的VSCode，拿不到用户环境变量，尤其%APPDATA%
pm和C:Program FilesGitin这类路径基本消失。
- 推荐做法：彻底退出VSCode（任务管理器结束所有
Code.exe进程），然后在PowerShell里执行code .启动 - 或者手动补PATH：VSCode设置中搜
terminal.integrated.env.windows，填入：{"PATH": "${env:PATH};C:\Users\XXX\AppData\Roaming\npm;C:\Program Files\Git\bin"}（注意反斜杠要双写） - 如果你用
nvm-windows，装完必须运行nvm use 18.19.0激活，否则node命令永远不可用
调试时提示“无法启动程序”，检查launch.json里的program
这个错误和PATH无关，是调试器找不到可执行JS文件。VSCode调试器只认编译后的.js，不认.ts、.mjs或未构建的源码。
-
"program"字段必须指向真实存在的JS文件，比如"${workspaceFolder}/dist/index.js"（TS项目）或"${workspaceFolder}/src/app.js"（纯JS） - ESM项目（
package.json含"type": "module"）需加"runtimeArgs": ["--experimental-specifier-resolution=node"] - 别把
runtimeExecutable设成npm或pnpm——调试器无法注入断点，会静默失败
最常被忽略的一点：改完PATH或shell配置后，VSCode不会自动重载，必须杀掉全部后台进程再重启——哪怕只是关了窗口，Code.exe可能还在内存里挂着，PATH照样不更新。
