如何在VSCode中解决Node环境由于多版本Node共存导致的PATH混淆-VSCode-PHP中文网

vscode终端里node -v显示旧版本，根本原因是启动时固化shell环境快照，nvm切换后主进程不刷新path；需通过code .启动或配置login shell加载~/.zshrc，而非仅改env设置。

如何在vscode中解决node环境由于多版本node共存导致的path混淆

VSCode启动时会固化shell的环境变量快照，nvm切换后主进程不会自动更新PATH。哪怕你在终端里执行nvm use 18.20.4，新打开的终端标签页仍可能沿用旧PATH。

解决方式不是改settings.json里的terminal.integrated.env.osx，而是让VSCode真正加载你的shell初始化文件：

macOS/Linux：确保~/.zshrc（或~/.bashrc）末尾有nvm初始化代码，并从终端执行code .启动VSCode（而非双击图标）
Windows（nvm-windows）：每次nvm use后，在VSCode中按Ctrl+Shift+P运行Terminal: Reload Shell Environment
验证是否生效：在VSCode集成终端中运行which node，输出应为~/.nvm/versions/node/v18.20.4/bin/node这类路径，而非/usr/local/bin/node

VSCode调试器默认不继承终端环境变量，它只查自己启动那一刻的PATH。所以即使终端里node -v是对的，F5仍可能调用系统自带或Electron内置的Node。

关键配置在项目根目录的.vscode/launch.json中：

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

启用"runtimeExecutable": "${env:NVM_BIN}/node"——注意大小写，NVM_BIN必须全大写
前提是NVM_BIN在VSCode环境中真实存在：在集成终端中运行echo $NVM_BIN，有输出才有效
若echo $NVM_BIN为空，先检查terminal.integrated.inheritEnv是否设为true，并**完全退出VSCode再重开**（仅关窗口无效）
不要硬编码路径如"runtimeExecutable": "/Users/x/.nvm/versions/node/v18.20.4/bin/node"，换机器就失效

VSCode插件（尤其是含原生模块的）运行在Electron内置Node上，不是你nvm use的那个版本。截至VSCode 1.90+，它用的是Node.js v22.4.0（napi_build_version=9）。

如果你用npm install装的是Node v20（napi=8），生成的.node文件根本加载不了：

重编译前先清空插件目录下的node_modules/.pnpm和out/，否则缓存优先被加载
执行npm rebuild --napi-build-version=9 --runtime=electron --target=34.0.0（对应Electron 34）
验证当前插件运行时的Node版本：在VSCode开发者工具控制台中运行process.versions.node和process.versions.napi

VSCode不读.nvmrc，nvm本身也不自动执行nvm use。所谓“项目级Node版本”必须显式触发：

最轻量做法：项目根目录放.nvmrc（内容如v16.20.2），打开项目后在终端手动执行nvm use
省事一点：安装插件vsc-nvm，它会在新终端启动时自动检测并执行nvm use（已存在的终端需重启）
Volta用户注意：.nvmrc写^18无效，只能用具体版本或lts，且必须先运行volta pin node@18.19.0生成.node-version