快速理顺VSCode中的Node环境-VSCode-PHP中文网

根本原因是vscode启动时未加载shell配置，导致nvm、volta等工具不可用且调试器沿用旧node版本；需启用terminal.integrated.inheritenv为true并彻底重启vscode，再在launch.json中配置"runtimeexecutable": "${env:nvm_bin}/node"，最后重启typescript server以同步语言服务。

快速理顺vscode中的node环境

VSCode 里 Node 版本错乱、调试跑旧版、终端找不到 nvm 或 volta，根本不是插件或配置文件写得不够多，而是环境变量没被正确加载——VSCode 启动时的进程环境和你在终端里手动执行命令的环境，压根不是一回事。

VSCode 终端里 `nvm` 命令不存在

这不是 nvm 没装好，是 VSCode 启动时没读你的 ~/.zshrc 或 ~/.bash_profile，PATH 里压根没加 ~/.nvm/bin。

打开 VSCode 设置（Cmd+,），搜 terminal.integrated.inheritEnv，设为 true
改完必须完全退出 VSCode（不只是关窗口），再重开
新开集成终端，运行 which nvm；如果返回 ~/.nvm/nvm.sh，说明加载成功
如果仍不行，检查你实际用的 shell：macOS 默认是 zsh，对应设置项是 terminal.integrated.env.zsh，手动加 NVM_DIR 和 PATH：

"terminal.integrated.env.zsh": {
  "NVM_DIR": "/Users/you/.nvm",
  "PATH": "/Users/you/.nvm/bin:${env:PATH}"
}

Windows 用户请直接用 nvm-windows，并手动把 C:\Users\you\AppData\Roaming\nvm 加进系统 PATH，重启 VSCode。

`nvm use` 成功但 F5 调试还是旧版本

调试器不继承终端环境，它启动时只认 VSCode 启动那一刻的 PATH。你在终端里 nvm use 18.17.0，对调试器完全无效。

OC SSH Tunnel Node Recovery

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

下载

在 .vscode/launch.json 中显式指定 "runtimeExecutable": "${env:NVM_BIN}/node"
确保 ${env:NVM_BIN} 有值：在集成终端里运行 echo $NVM_BIN，应输出类似 /Users/you/.nvm/versions/node/v18.17.0/bin
别硬编码路径，比如 "runtimeExecutable": "/Users/xxx/.nvm/versions/node/v18.17.0/bin/node" —— 换机器就挂
如果 $NVM_BIN 为空，说明 nvm 没加载成功，回到上一步检查 inheritEnv 和 shell 初始化

Volta 不自动切 Node 版本

Volta 不会监听目录变化，也不会自动生成 .node-version。它只读，不写。没这个文件，它就用默认版本（通常是最新 stable）。

在项目根目录运行 volta pin node@18.19.0（注意：不支持 ^18 这种范围写法）
确认 VSCode 终端启动的是 login shell：zsh -l 或 bash -l；macOS 上可在设置里设 terminal.integrated.defaultProfile.osx 为 zsh
检查 ~/.zshrc 或 ~/.zprofile 是否包含 Volta 提示的那行：export PATH="$HOME/.volta/bin:$PATH"
验证：volta list node 应显示已安装版本，which node 应指向 ~/.volta/bin/node

JS/TS 语言服务报 Node 版本不匹配

VSCode 的 TypeScript Server 启动时固定读一个 Node 可执行文件，跟终端无关。改了 nvm use 或 volta pin，它不会自动重启或重载。

按 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Win/Linux），输入 Typescript: Restart TS server 手动触发
或者直接关掉 VSCode 再重开——这是最稳的办法
如果你用 volta，且 which node 已指向 .volta/bin/node，重启 TS Server 后，类型检查和 IntelliSense 就会按 .node-version 里的版本解析
注意：.nvmrc 对 Volta 有效（只读），但 .node-version 对 nvm 无效（nvm 不读它）