答案是abi版本不匹配：vscode 1.90+内置node.js 22.4.0（napi_build_version=9），而预编译的.xxx.node模块多为napi=8，加载时被静默拒绝，非路径或文件缺失问题。
为什么 require('./xxx.node') 报错“Cannot find module”
不是路径写错了，也不是文件丢了，而是 VSCode 扩展主机进程加载原生模块时，强制校验 Node.js ABI 版本。VSCode 1.90+（2026 Q1 起）内核升级到 Node.js 22.4.0，ABI 版本从 v8 升至 v9，但多数预编译的 .node 文件仍链接 napi_build_version=8，直接被拒绝加载，控制台只显示 Cannot find module './build/Release/xxx.node'，无堆栈、不报 ABI 错误。
如何确认是 ABI 不匹配而非路径或权限问题
打开 VSCode 开发者工具（Help → Toggle Developer Tools），在 Console 中执行：
process.versions.napi
若输出 "9"，而你插件的 .node 文件来自旧版构建（比如用 Node.js 20.x 编译），就必然失败。别信 node -v 输出——VSCode **不使用系统 Node.js**，它自带 Electron 内置的 Node.js 运行时，路径藏在安装目录里，比如：
- macOS：
Visual Studio Code.app/Contents/Frameworks/Code Helper (Renderer).app/Contents/MacOS/Code Helper (Renderer) - Windows：
%USERPROFILE%\AppData\Local\Programs\Microsoft VS Code\Code.exe对应的 Helper 进程
运行该二进制 + node -v 和 process.versions.napi 才是真实环境。
诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。
重编译 .node 文件必须用 VSCode 内置 Node.js
用系统 npm rebuild 会默认调系统 Node.js，生成 ABI v8 模块，依旧无效。必须显式调用 VSCode 自带的 Node.js 可执行文件，并传对参数：
- 进入插件目录：
cd ~/.vscode/extensions/your-plugin-id-1.2.3 - 执行（macOS 示例，路径需按实际调整）：
~/.vscode/Code.app/Contents/Frameworks/Code\ Helper\ \(Renderer\).app/Contents/MacOS/Code\ Helper\ \(Renderer\) --type=extensionHost node /usr/bin/npm rebuild --napi-build-version=9 --runtime=electron --target=34.0.0
- Windows/Linux 类似，关键是把
Code Helper (Renderer)的完整路径作为前缀，确保node命令实际由 VSCode 提供的运行时执行 - 完成后删掉
./out/和./node_modules/.pnpm/node_modules/，避免缓存干扰
.vsix 安装后仍加载失败？检查 engines.vscode 和签名兼容性
手动安装 .vsix 不等于绕过所有校验。VSCode 1.85+ 启用严格签名验证，且会读取 package.json 中的 engines.vscode 字段：
- 用 ZIP 工具打开
.vsix，检查根目录下package.json的"engines": {"vscode": "^1.90.0"}—— 若你用的是 1.89.x，即使 ABI 正确也会静默拒绝 - TLS 1.3 默认启用，某些老旧
.vsix签名只适配 TLS 1.2，会导致校验失败，无明确提示 - 不要尝试解压改
package.json再重打包 —— 签名失效，VSCode 直接跳过加载
真正麻烦的从来不是找不到文件，而是加载过程被 ABI、签名、引擎版本三重拦截，且错误信息被刻意压制 —— 控制台一片空白，只剩图标灰着不动。
