VSCode本身不管理Node.js版本，所有版本不一致问题均源于终端、调试器、插件主机三者加载的node路径不同；需统一nvm环境：macOS/Linux启用terminal.integrated.inheritEnv并完全重启VSCode，Windows执行Terminal: Reload Shell Environment，launch.json中runtimeExecutable应设为${env:NVM_BIN}/node，项目级统一推荐.nvmrc配合手动nvm use。
VSCode 本身不管理 Node.js 版本，所有“版本不一致”问题都源于终端、调试器、插件主机三者加载的 node 实际路径不同——不是 VSCode 配错了，而是你没让它们读到同一个 nvm 环境。
终端里 nvm 不生效？检查是不是 login shell
VSCode 集成终端默认不是 login shell，所以 ~/.zshrc 或 ~/.bash_profile 里的 source ~/.nvm/nvm.sh 根本不会执行。结果就是：which nvm 返回空、$NVM_DIR 未设置、nvm use 报 command not found。
- macOS/Linux：在
settings.json中启用继承环境："terminal.integrated.inheritEnv": true，然后**完全退出 VSCode（关窗口不算）再重开** - 更稳妥的做法：直接从终端启动 VSCode，比如
code .，确保它加载了你的 shell 配置 - Windows（nvm-windows）：每次
nvm use后，必须手动执行Terminal: Reload Shell Environment（Ctrl+Shift+P） - 验证是否成功：新开终端后运行
nvm current和which node，两者应指向~/.nvm/versions/node/v18.18.2/bin/node这类路径
launch.json 里 runtimeExecutable 为啥不生效？
它只控制调试进程的 node 可执行文件路径，完全不继承终端当前的 PATH 或 NVM_BIN。所以终端里 node -v 是 v18.18.2，F5 却跑 v16.20.2，非常正常。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 必须写成：
"runtimeExecutable": "${env:NVM_BIN}/node"，不能硬编码路径（换机器就失效） - 前提是终端已确认
$NVM_BIN非空，否则${env:NVM_BIN}展开为空，调试器 fallback 到系统默认node - 这个字段对
npm run dev类脚本无效——它只管 debugger 进程，不影响终端任务或 ESLint 插件 - 如果用
runtimeVersion，VSCode 会尝试调用nvm exec 18.18.2 node，但要求nvm在$PATH且目标版本已安装，否则报Cannot find module 'nvm'
如何让整个工作区统一用指定 Node 版本？
靠 .nvmrc + 手动触发 nvm use 是最轻量、兼容性最好的方式，不需要任何 VSCode 插件介入。
- 项目根目录新建
.nvmrc，内容只有一行：18.18.2 - 打开集成终端后，先运行
nvm use（它会自动读.nvmrc） - 可配成启动任务：在
.vscode/tasks.json里加一个shell类型任务，命令为nvm use - 多项目混开时，别依赖全局设置——每个项目根目录放自己的
.vscode/settings.json，并确保terminal.integrated.cwd指向${workspaceFolder} - 避免混用
volta或fnm：.tool-versions和.nvmrc互不识别，选一个工具并坚持用到底
插件报 Cannot find module './build/Release/xxx.node' 怎么办？
这不是 Node 版本号不匹配，而是 N-API ABI 版本错位。VSCode 插件运行在内置 Electron 的 Node 上（比如 v22.4.0 / napi_build_version=9），而你本地 node 是 v20.x（napi=8），二进制无法加载。
- 重编译原生模块时，必须指定完整参数：
npm rebuild --napi-build-version=9 --runtime=electron --target=34.0.0 - 务必先清空插件目录下的
node_modules/.pnpm和out/，否则旧缓存优先被加载 -
process.versions.napi和process.versions.node才是真实运行时依据，node -v输出只是表象 - 真正麻烦的不是配置本身，而是终端靠 shell 初始化、调试器靠
runtimeExecutable或nvm exec、任务靠tasks.json显式调用——四者读取环境的方式根本不同
