VSCode集成终端报“command not found”根本原因是未继承系统PATH：macOS/Linux因GUI启动不加载~/.zshrc等配置，Windows则常因Node.js安装时未勾选“Add to PATH”或路径未生效；验证需在VSCode终端执行node -v，修复须彻底重启VSCode并确保shell配置或系统环境变量正确写入。
VSCode 本身不管理环境变量，它只继承启动时所在 shell 或系统已有的 PATH；所谓“配置”，其实是让 VSCode 能读到你终端里已有的 node 命令。
为什么终端能用 node，但 VSCode 集成终端报 command not found
根本不是 VSCode 设置错了，而是它没加载你的 shell 初始化文件（比如 ~/.zshrc 或 ~/.bash_profile），或者 Windows 系统级 PATH 根本没包含 Node.js 安装路径。
- macOS/Linux：从 Dock、Spotlight 或桌面图标启动 VSCode 时，不会触发 shell 的 profile 加载，
PATH里自然没有node - Windows：Node.js 安装时若没勾选 Add to PATH，系统变量里就压根没这行，VSCode 无论怎么重启都找不到
- 验证方式：在 VSCode 内置终端（
Ctrl + `）里直接运行node -v，没输出就别往下配launch.json了
macOS/Linux：让 VSCode 读到 ~/.zshrc 里的 PATH
不能只 source ~/.zshrc，必须让 VSCode 进程本身启动在正确的 shell 上下文中。
- 先确认
which node输出路径（如/opt/homebrew/bin/node），再检查该路径是否已写进~/.zshrc的export PATH="...:$PATH"中 - 改完
~/.zshrc后，**彻底退出所有 VSCode 窗口**，再从终端执行：code --no-sandbox . - 不推荐用
Developer: Reload Window—— 它只重载 UI，不重建进程环境，PATH 不会更新
Windows：PATH 没加进去是最常见原因
别信“安装时勾选了”，很多用户实际漏选，或安装后被其他软件覆盖 PATH。重装是最稳妥的解法。
- 打开「系统属性 → 高级 → 环境变量」，在「系统变量」的
Path里查找是否有C:\Program Files\nodejs\ - 如果没有，手动添加；如果有但依然报错，大概率是路径拼写错误（比如多了空格、斜杠方向不对）或权限问题
- 更推荐：卸载 Node.js，重新下载 LTS 版本，安装时**务必勾选 Add to PATH**，并确保安装路径不含中文或空格
调试器 runtimeExecutable 和系统 PATH 是两回事
即使 node -v 在终端和 VSCode 里都能跑，调试器仍可能报 Cannot find runtime 'node' —— 因为它默认不走系统 PATH，尤其当你用了 nvm、fnm 或 volta。
- 检查项目下的
.vscode/launch.json，如果里面有"runtimeExecutable"字段，且路径写死了（比如指向~/.nvm/versions/node/v18.17.0/bin/node），那它就完全绕过 PATH - 想让它走默认逻辑？删掉
runtimeExecutable这一行，让调试器自己查PATH - 用了版本管理工具又想稳定调试？显式指定路径最可靠，但注意路径中不要用
~，要用绝对路径（/Users/xxx/.nvm/...）
真正容易被忽略的是：VSCode 的环境变量继承是一次性的，发生在进程启动那一刻。改完 shell 配置或系统 PATH 后，不杀干净所有 VSCode 进程再重开，就永远继承不到新值。这不是缓存问题，是进程生命周期问题。
