VSCode中搭建Node环境：nvm与Node版本的管理方法-VSCode-PHP中文网

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环境：nvm与node版本的管理方法

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 显式调用——四者读取环境的方式根本不同