终端、调试器、插件主机各自认的node版本不一致，是因为node命令走终端PATH、调试器依赖launch.json或启动时环境快照、插件主机强制使用VSCode内置Electron绑定的Node（如v22.4.0/napi=9），而原生模块编译需严格匹配napi_build_version；四者加载路径与时机不同导致错位。
为什么终端、调试器、插件主机各自认的 node 版本不一样
这不是 VSCode “配错了”，而是它内部四个关键组件加载 Node 的时机和路径来源完全不同：node 命令走终端 PATH，调试器读 launch.json 或系统 PATH，插件主机（Extension Host）强制使用 VSCode 内置 Electron 绑定的 Node（如 v22.4.0），而原生模块（如 sqlite3）编译时又依赖 napi_build_version 匹配。四者错位，就会出现“终端里 node -v 是 v18，F5 调试却报 Cannot find module './build/Release/xxx.node'”。
- VSCode 启动时固化 shell 环境快照，
nvm use切换后主进程不刷新PATH -
launch.json中的runtimeExecutable只控制调试进程，不影响插件主机 - 插件实际运行在 Electron 的 Node 上，
process.versions.napi必须与npm rebuild时指定的--napi-build-version一致
which node 在终端里正确，但 F5 还是用旧版怎么办
调试器根本不管终端当前用了哪个 node，它只认 launch.json 显式配置或启动时的环境变量快照。硬编码路径易失效，推荐用环境变量动态引用。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 确保终端已执行
nvm use v18.20.4，且$NVM_BIN非空（echo $NVM_BIN验证） - 项目根目录下
.vscode/launch.json中写："runtimeExecutable": "${env:NVM_BIN}/node"，不是/Users/xxx/.nvm/versions/node/v18.20.4/bin/node - Windows 用户若用
nvm-windows，必须在 VSCode 里按Ctrl+Shift+P→Terminal: Reload Shell Environment，否则$NVM_BIN不生效
装了 sqlite3 却提示 xxx.node 找不到
这是典型的 N-API 版本错配：你系统 node 是 v20（napi=8），但 VSCode 插件主机跑的是 v22.4.0（napi=9），npm install 默认按系统 Node 编译，结果插件加载失败。
- 先清空插件目录下的
node_modules/.pnpm和out/，避免旧缓存干扰 - 重编译必须带三参数：
npm rebuild sqlite3 --napi-build-version=9 --runtime=electron --target=34.0.0 -
--target=34.0.0对应 VSCode 1.90+ 的 Electron 34，不可省略；--napi-build-version=9必须与process.versions.napi输出一致
如何让 VSCode 终端真正继承 nvm 切换后的环境
改 settings.json 里的 terminal.integrated.env.osx 是陷阱——它会覆盖整个 PATH，导致 git、curl 等命令失效。关键是让终端启动时加载正确的 shell 初始化文件。
- macOS/Linux：确认
~/.zshrc（或~/.bash_profile）末尾有完整nvm初始化代码，且 VSCode 必须从终端启动：code . - Windows：
nvm-windows用户每次nvm use后，必须在 VSCode 里执行Terminal: Reload Shell Environment - 验证方式：在 VSCode 终端里运行
which node，输出应为~/.nvm/versions/node/v18.20.4/bin/node，而非/usr/local/bin/node
node 对齐。 
