vscode本身不升级node.js，问题源于运行时错位和napi版本不匹配：终端仍用旧版因启动时固化环境快照，需完全重启vscode；原生模块报错需确保process.versions.napi与npm rebuild指定的--napi-build-version一致。
VSCode 本身不升级 Node.js，所谓“升级后不兼容”，其实是你手动升级了系统 Node.js，但 VSCode 的各个子系统（终端、调试器、插件主机）没同步加载新版本，或原生模块 ABI 不匹配——问题不在 VSCode，而在运行时错位和 napi 版本对不上。
为什么 VSCode 终端里 node --version 还是旧版
这不是 PATH 没配好，而是 VSCode 启动时固化了 shell 环境快照。nvm 切换后主进程不刷新 PATH，导致终端仍用旧 node。
- Windows：任务管理器中结束所有
Code.exe进程，再重启 - macOS：Dock 右键 → Quit（不是关窗口），然后从终端执行
code .启动 - nvm-windows 用户：每次
nvm use后，在 VSCode 中按Ctrl+Shift+P执行Terminal: Reload Shell Environment - 验证方式：在 VSCode 终端运行
which node，输出应指向~/.nvm/versions/node/vxx.x.x/bin/node
Cannot find module './build/Release/xxx.node' 怎么办
这是原生模块 ABI 不兼容的典型错误，常见于 VSCode 1.90+（内置 Node.js 22.4.0，napi_build_version=9），而你用系统 Node.js v20.x（napi=8）执行了 npm rebuild，生成的二进制无法被加载。
OC SSH Tunnel Node Recovery
下载
诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。
- 重编译前必须清空插件目录下的
node_modules/.pnpm和out/，否则旧缓存优先被加载 - 重编译命令要带全参数：
npm rebuild --napi-build-version=9 --runtime=electron --target=34.0.0 - 确认插件实际运行环境：在插件控制台或输出通道打印
process.versions.napi，必须等于 9 才能加载 - 别只看
process.version，napi_build_version才是关键
插件报 module not found 但项目里能跑
说明 Node.js 环境没问题，但插件自己的 node_modules 缺依赖——VSCode 插件不复用你项目的依赖，它需要独立安装。
- 打开插件源码根目录（不是你的业务项目），运行
npm install - 检查
node_modules是否包含插件package.json中声明的dependencies（如axios、@dify/plugin-core） - 打包前必须执行
vsce package，它不会自动装依赖，只打包已存在的node_modules - 调试时若仍报错，检查
launch.json的program是否指向正确入口（如${workspaceFolder}/out/extension.js），并确认没误设NODE_PATH
最易被忽略的是：ABI 兼容性不是“Node.js 版本够新就行”，而是 process.versions.napi 必须与插件编译时指定的 --napi-build-version 完全一致——差 1 都加载失败。
