VSCode终端中node -v报command not found，根本原因是集成终端未正确继承系统PATH：macOS/Linux因非登录shell跳过shell配置文件，Windows因启动方式未加载用户环境变量；需分别通过启用login shell或手动补全PATH修复，并彻底重启VSCode生效。
VSCode终端里输入node -v报command not found，不是Node没装，是终端压根没拿到你的PATH——系统终端能跑，VSCode里挂了，说明环境链路断在启动环节。
为什么VSCode终端不继承系统PATH
macOS/Linux默认用non-login shell启动集成终端，直接跳过~/.zshrc、~/.bash_profile，所有export PATH=都不生效；Windows上双击图标启动的VSCode，拿不到用户级环境变量（比如%APPDATA%
pm），只继承系统级PATH的快照。
- 验证方法：在VSCode终端执行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），再把同一命令粘贴到iTerm/Terminal/CMD/PowerShell里执行，逐行比对 - 缺了这些路径基本就确诊了：
/opt/homebrew/bin（Apple Silicon Homebrew）、$HOME/.nvm/versions/node/v18.18.2/bin（nvm管理的Node）、%APPDATA% pm（Windows npm全局模块）、~/.local/bin（pip install --user安装的命令） - 别信“我改了配置文件就完事了”——改完
~/.zshrc后必须source ~/.zshrc，且VSCode要彻底退出再重开，否则进程仍用旧环境
macOS/Linux：必须启用login shell
VSCode默认不走login流程，所以~/.zshrc里的PATH永远不加载。修复只需两步，但顺序不能错：
- 打开VSCode设置（Cmd + ,），搜索
terminal.integrated.profiles，找到对应shell（如zsh），确认其args字段为["-l"]（小写L，不是数字1） - 关闭所有已打开的集成终端——不只是关标签页，要确保终端进程被杀掉（macOS Activity Monitor查
zsh进程，Windows任务管理器查Code.exe子进程） - 按
Ctrl + `新建终端，再运行echo $PATH验证；如果仍无效，检查~/.zshrc开头是否有[[ -n $ZSH_EVAL_CONTEXT ]] && return这类提前退出逻辑，临时加一行echo "zshrc loaded"就能确认是否真被读取
Windows：PATH补全比重装更有效
PowerShell报The term 'npm' is not recognized，90%不是权限问题，而是PATH缺失。先查真实路径：where node（CMD）或Get-Command node（PowerShell），输出可能是C:Program Files
odejs
ode.exe或D:
vm4w
odejs
ode.exe（nvm-windows路径）。
- 如果路径不对，去「系统属性 → 高级 → 环境变量」，把正确路径加到「用户变量」的
Path里（别只加系统变量，普通用户登录时不一定继承） - 更稳妥的做法是在VSCode设置JSON中手动拼接：
"terminal.integrated.env.windows": { "PATH": "${env:PATH};D:\nvm4w\nodejs" }（注意双反斜杠和分号） - PowerShell执行策略限制常被误判为PATH问题：运行
Get-ExecutionPolicy -Scope CurrentUser，若返回Restricted，就在管理员权限PowerShell里执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，然后关掉所有终端再新建
调试器F5失败 ≠ 终端能用
终端里node -v成功，但F5调试报Cannot find runtime 'node'，是因为VSCode调试器（launch.json）启动的是全新进程，完全不继承终端环境变量——它的PATH是空的，除非你手动喂进去。
-
launch.json里不能写environment（已弃用），得用env字段："env": { "PATH": "${env:PATH};/usr/local/bin" } - Windows路径拼接用
;，Linux/macOS用:；平台键要写对：terminal.integrated.env.windows、.linux、.osx - 别在
configurations外层写env，那位置无效；也别指望envFile自动补PATH，它只读.env里的键值对 - 如果用了
nvm/fnm/volta，调试器默认不识别版本切换逻辑；最稳做法是显式指定runtimeExecutable，例如："runtimeExecutable": "C:\nodejs\node.exe"
PATH问题最麻烦的点不在配置本身，而在“你以为改完了，其实进程还挂着旧环境”。每次修改后，必须确认VSCode所有进程已退出（macOS右键Dock → Quit，Windows任务管理器结束全部Code.exe），再从干净状态启动——这是最容易被跳过的硬性步骤。
