vscode无法识别node命令的根本原因是未继承shell配置的path；macos/linux需从终端执行code启动或设shellargs为["-l"]，windows需确认安装时勾选add topath并重启vscode。

VSCode 无法识别 node 命令，不是插件没装好，而是它根本没继承你 shell 里配好的 PATH。 这问题在 macOS/Linux 上尤其常见——从 Dock 或 Spotlight 启动 VSCode，进程不加载 ~/.zshrc；Windows 则常因安装时漏勾 Add to PATH，导致 C:Program Files odejs 根本不在系统变量里。验证只有一招：node -v 在 VSCode 内置终端（Ctrl + `）里执行，没输出就别碰 launch.json 或调试器——全是白忙。

终端里 node -v 报 command not found 怎么办

先确认 Node 是否真装对、PATH 是否真生效：

• macOS/Linux：打开终端，执行 which node 和 echo $PATH，看输出路径是否包含 Node 安装目录（比如 /opt/homebrew/bin/node 或 /usr/local/bin/node）
• Windows：在 CMD 或 PowerShell 里跑 where node，检查返回路径是否是 C:Program Files odejs ode.exe（注意不是 node_modules 下的）
• 如果 shell 里 node -v 有输出，但 VSCode 终端没有：说明 VSCode 启动方式绕过了 shell 初始化——macOS/Linux 必须从终端执行 code --no-sandbox . 启动；Windows 则需彻底退出所有 VSCode 窗口再重开
• 如果 shell 里也没输出：卸载 Node.js，重装 LTS 版，安装时务必勾选 Add to PATH，路径避开中文和空格

terminal.integrated.env.* 注入 PATH 的实操要点

当没权限改系统变量，或项目需指定 Node 版本（比如用 nvm 管理），就得靠 VSCode 自己的环境变量注入机制。它不覆盖系统 PATH，而是把指定路径“前置”进去，优先级更高：

OC SSH Tunnel Node Recovery

诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。

下载

• 全局生效：在 VSCode 设置中搜 terminal.integrated.env，点开对应系统项（.windows / .linux / .osx），编辑 settings.json
• 局部生效：在项目根目录建 .vscode/settings.json，内容同上，但路径必须指向 node.exe 所在目录（例如 "PATH": "/Users/you/.nvm/versions/node/v18.18.2/bin:${env:PATH}"）
• Windows 路径写法：用正斜杠 / 或双反斜杠 \，禁止混用单反斜杠
• ${env:PATH} 必须保留——删了会导致 npm、git 等命令失效
• 改完保存后，必须彻底退出 VSCode 再重开，仅重载窗口无效

launch.json 里 runtimeExecutable 不认 node 怎么办

即使终端里 node -v 正常，调试器仍报 Cannot find runtime 'node'，因为调试器和终端用的是两套环境变量逻辑：

• 在 launch.json 的配置里显式指定 runtimeExecutable，例如："runtimeExecutable": "/usr/local/bin/node"（macOS/Linux）或 "runtimeExecutable": "C:\Program Files\nodejs\node.exe"（Windows）
• 路径必须是绝对路径，且指向可执行文件（node.exe 或 node），不是目录
• 如果用 nvm，不能写 ~/.nvm/versions/node/v18.18.2/bin/node —— ~ 在调试器里不展开，得写全路径（如 /Users/you/.nvm/versions/node/v18.18.2/bin/node）
• Windows 注意反斜杠转义：JSON 里写成 "C:\Program Files\nodejs\node.exe"

真正卡住人的地方，往往不是配置多复杂，而是终端 PATH 和调试器 runtimeExecutable 这两层环境变量被当成一回事——它们独立加载、互不影响。改完任一环节，都得验证对应场景（终端执行 vs F5调试），不能只测一个。