必须确保Node.js路径已写入系统PATH，否则VSCode（含调试器和终端）无法识别node；验证方式为在VSCode内置终端执行node -v，无输出则说明环境未生效；macOS/Linux需从终端启动code命令，Windows需检查系统环境变量中是否包含Node.js安装路径。

不需要单独为 VSCode 配置系统环境变量，但必须确保 Node.js 的安装路径已写入操作系统级 PATH，否则 VSCode（尤其是其调试器和终端）根本找不到 node。

VSCode 本身不管理环境变量，它只继承启动时所在进程的环境。你双击图标、从 Dock 或 Spotlight 启动 VSCode，它就不会加载你的 ~/.zshrc 或 PATH 设置；Windows 下如果安装 Node.js 时没勾选 “Add to PATH”，那系统变量里压根就没有 C:\Program Files\nodejs\ 这一行——VSCode 再怎么配也白搭。

---

为什么终端里 node -v 没输出？

这是最核心的判断起点。别跳过这步，所有后续配置都依赖它。

• 在 VSCode 内置终端（Ctrl + `）里直接运行 node -v
• 没输出或报 command not found → 说明 VSCode 进程根本没拿到 node 路径
• 此时配 launch.json、改 settings.json 全是无效操作

常见原因：

Baidu Search Node

使用 Node.js 脚本调用百度搜索 API，按关键字和数量获取搜索结果的排名、标题、摘要和链接。

下载

• macOS/Linux：GUI 启动 VSCode 不读 ~/.zshrc，哪怕你里面写了 export PATH="/opt/homebrew/bin:$PATH"
• Windows：Node.js 安装时漏选 “Add to PATH”，或手动添加时路径拼错（比如写成 C:\Program Files\nodejs 少了末尾反斜杠，或用了中文路径）

验证方式：

• macOS/Linux：终端里执行 which node，把输出路径确认已加进 ~/.zshrc，然后彻底退出所有 VSCode 窗口，再从终端运行 code --no-sandbox .
• Windows：打开「系统属性 → 高级 → 环境变量」，在「系统变量」的 Path 里找 C:\Program Files\nodejs\，注意斜杠方向、空格、权限

---

terminal.integrated.env.* 是绕过系统 PATH 的临时方案

当你没权限改系统变量（比如公司内网锁死），或需要单项目指定 Node 版本（比如用 nvm 管理多个版本），才用这个。

• 全局生效：在 VSCode 用户设置里搜 terminal.integrated.env.windows（macOS/Linux 对应 .linux），编辑 JSON：

  {
  "terminal.integrated.env.windows": {
    "PATH": "C:/your/node/path;${env:PATH}",
    "NODE_PATH": "C:/your/node/path"
  }
  }
  

• 局部生效：在项目根目录建 .vscode/settings.json，内容同上
• 关键点：
  • ${env:PATH} 必须保留，否则会丢掉 npm、git 等命令
  • 路径用正斜杠 / 或双反斜杠 \，不能混用单反斜杠 \
  • 改完必须彻底重启 VSCode（不是重载窗口），否则新环境不生效

---

runtimeExecutable 在 launch.json 中会完全忽略系统 PATH

即使 node -v 在终端里能跑通，调试器仍可能报 Cannot find runtime 'node'。

• 检查项目下是否有 .vscode/launch.json
• 如果里面有 "runtimeExecutable": "/xxx/node" 这种硬编码路径，它就不走系统 PATH，也不认 nvm 切换结果
• 解决方案：
  • 没必要指定时：直接删掉 runtimeExecutable 字段，让调试器走默认查找逻辑
  • 必须指定（如多版本共存）：写绝对路径，~/ 不生效，~/.nvm/versions/node/v18.17.0/bin/node 可以，但得确保该路径真实存在且有执行权限
  • 用 volta/fnm 的用户：显式写死是唯一稳妥方案，别指望 PATH 自动生效

---

真正容易被忽略的是：VSCode 的终端和调试器用的是两套环境加载逻辑，且它们都不“主动配置”环境变量——只是被动继承。你改了 ~/.zshrc 却没重启 VSCode 进程，或者 Windows 下 PATH 写对了但没刷新系统级缓存，问题就会卡死在这一步。