vscode 中 node -v 报 command not found 是因未继承 shell 或系统 path。需验证内置终端是否识别 node，检查并修复 path 配置，macos/linux 要从终端启动 vscode 以加载 ~/.zshrc，windows 需确保 node 路径已添加至系统环境变量，且必须彻底重启 vscode 进程。
VSCode 里 node -v 报 command not found，不是 Node 没装好，而是它根本没读到你 shell 或系统里配的 PATH。
先验证：VSCode 终端里到底有没有 node
别信系统终端能跑就万事大吉。打开 VSCode 内置终端（Ctrl + `），立刻执行：
-
node -v—— 没输出？停在这步，别碰launch.json -
which node（macOS/Linux）或where node（Windows）—— 看是否返回真实路径 -
echo $PATH（macOS/Linux）或echo %PATH%（CMD）或$env:PATH（PowerShell）—— 对比系统终端输出，缺了/usr/local/bin、/opt/homebrew/bin或C:Program Files odejs就坐实了 PATH 缺失
macOS/Linux：GUI 启动不加载 ~/.zshrc 是默认行为
从 Dock、Spotlight 或桌面图标启动 VSCode，进程不走 login shell 流程，~/.zshrc 里的 export PATH=... 完全被跳过。
- 改
~/.zshrc后，必须彻底退出所有 VSCode 进程（macOS 右键 Dock →「退出」，不是关窗口） - 然后从终端执行：
code --no-sandbox .—— 这样启动的 VSCode 才会继承当前 shell 的环境 - 如果
~/.zshrc开头有[[ -n $ZSH_EVAL_CONTEXT ]] && return这类防护逻辑，加一行echo "zshrc loaded"验证是否真被读取 - 不推荐靠
terminal.integrated.shellArgs: ["-l"]临时补救 —— 它只影响新打开的终端标签页，不影响调试器或任务系统
Windows：PATH 没写进系统变量是主因
Node.js 安装时漏选「Add to PATH」，或者安装路径含空格/中文，又或者被其他软件覆盖，都会导致 VSCode 找不到 node.exe。
- 先查真实路径：
where node（CMD）或Get-Command node（PowerShell），确认输出是不是C:Program Files odejs ode.exe或类似路径 - 去「系统属性 → 高级 → 环境变量」，在「系统变量」的
Path里手动添加完整路径（注意斜杠方向、无多余空格） - 若用
nvm-windows，路径可能是D: vm4w odejs，此时建议在 VSCode 设置中补 PATH："terminal.integrated.env.windows": { "PATH": "${env:PATH};D:\nvm4w\nodejs" } - 改完必须彻底关闭并重启 VSCode ——
Developer: Reload Window不重载进程环境，PATH 不会更新
调试器和终端的 PATH 是两套体系
就算 node -v 在终端里跑通了，F5 调试仍报 Cannot find runtime 'node'，是因为 VSCode 调试器（launch.json）启动的是干净进程，不继承终端环境。
- 检查项目根目录下是否有
.vscode/launch.json，里面是否写了"runtimeExecutable": "/xxx/node"—— 有就删掉，让调试器走默认查找逻辑 - 若必须指定（比如用
fnm或volta），路径得是绝对路径："/Users/xxx/.fnm/versions/v18.17.0/bin/node"，不能带~ - 不要在
launch.json外层写env字段，无效；要喂 PATH 给调试器，得在具体configurations里加："env": { "PATH": "${env:PATH}:/usr/local/bin" } - Windows 下拼接用
;，macOS/Linux 用:，平台键必须对：terminal.integrated.env.windows、.linux、.osx
最常被忽略的一点：VSCode 的 tasks、debugger、code-runner 都不共享终端的 shell 初始化逻辑。你改了 ~/.zshrc，只重启终端标签页没用；你加了系统 PATH，不彻底退出 VSCode 进程，它就永远读不到。环境变量这事，本质是进程启动时的快照，不是运行时可热更新的配置。
