process.versions.napi比node -v更重要，因为原生模块加载取决于napi_build_version而非Node版本号；VSCode插件运行在Electron内置Node上，其process.versions.napi必须与编译时--napi-build-version完全一致，否则报Cannot find module错误。
为什么process.versions.napi比node -v更重要
Node.js版本号只是表象，真正决定原生模块能否加载的是napi_build_version。VSCode插件（尤其是含.node二进制的）运行在Electron内置Node上，不是你终端里node -v显示的那个。比如VSCode 1.90+用的是Node.js 22.4.0、napi_build_version=9，而你系统装的是v20.12.2（napi=8），npm rebuild生成的模块直接被拒绝加载——报错Cannot find module './build/Release/xxx.node'就是典型症状。
- 验证方式：在插件输出面板或调试控制台执行
console.log(process.versions)，重点看napi字段 - 不要只比对
process.versions.node，process.versions.napi必须与编译时指定的--napi-build-version完全一致 - 不同VSCode版本对应的
napi_build_version值不同，查官方Electron版本映射表比查Node官网更准
launch.json的runtimeExecutable不解决插件兼容性问题
runtimeExecutable只影响调试会话的主进程，不影响扩展主机（Extension Host）。也就是说，你设了"runtimeExecutable": "/Users/me/.nvm/versions/node/v20.12.2/bin/node"，断点能跑，但ESLint或Prettier这类依赖原生模块的插件依然用VSCode内置Node，照样报错。
- 常见误操作：以为改了
runtimeExecutable就万事大吉，结果插件日志里持续刷Module did not self-register - 真正要重编译的是插件自身的
node_modules，路径通常在~/.vscode/extensions/xxx/out/或~/.vscode/extensions/xxx/node_modules/ - 重编译命令必须带全参数：
npm rebuild --napi-build-version=9 --runtime=electron --target=34.0.0，缺一不可
终端里node -v显示旧版？不是PATH没配对，是环境快照没刷新
VSCode图形界面启动时固化了shell环境快照，nvm use之后它根本不知道PATH变了。macOS/Linux下从Dock点击图标启动，读的是~/.bash_profile而非~/.zshrc；Windows上nvm-windows用户不手动触发Terminal: Reload Shell Environment，终端永远认不到新版本。
- 验证方法：在VSCode终端执行
which node，输出路径应指向~/.nvm/versions/node/vxx.x.x/bin/node，否则就是环境没继承 - macOS/Linux正确做法：关闭所有VSCode进程，从终端执行
code .启动，确保加载当前shell配置 - Windows用户务必勾选nvm-windows安装时的
Add to PATH选项，否则where node可能返回空
跨版本API调用失败时，先看Vitest或测试框架是否绕过了Node ABI校验
Vitest默认启用pool: 'threads'，但在Node.js v20+和VSCode内置Node混合环境下，worker_threads的ABI不一致会导致Segmentation fault或Failed to Terminate Worker。这不是代码逻辑问题，而是底层线程模型不兼容。
- 临时绕过：把
vitest.config.js里的pool从threads改成forks，用进程隔离替代线程共享 - 长期方案：统一测试运行时，让Vitest显式使用VSCode内置Node——通过
test.runtimeOptions或环境变量VITEST_NODE_OPTIONS传递--require路径 - 注意
fetch、globalThis.crypto等新API在旧Node中不存在，不能只靠try/catch兜底，得用process.versions.node做精确判断
process.versions输出，比翻文档查兼容性列表更直接。 
