必须彻底卸载系统级node.js并清理残留路径，再安装nvm管理多版本；通过nvm install/use切换至项目所需版本（如v14.21.3），配合.nvmrc实现自动绑定，国内用户需配置镜像源避免超时。
VSCode里node -v报错或显示旧版本？先清空系统残留
这不是VSCode的问题，而是系统PATH里还挂着旧的Node.js路径。nvm要求干净环境，否则nvm use切换无效，VSCode终端仍会调用原生node。
- Windows：控制面板卸载Node.js → 手动删掉
C:\Program Files\nodejs、C:\Users\用户名\AppData\Roaming\npm、C:\Users\用户名\AppData\Roaming\npm-cache - macOS/Linux：运行
which node和which npm，删掉对应路径；检查~/.bashrc或~/.zshrc里是否有export PATH=...硬编码指向Node目录 - 验证：打开全新终端（不是VSCode内置终端），执行
node -v应提示“command not found”
nvm安装后VSCode终端不识别nvm命令？检查Shell配置加载
VSCode内置终端默认启动的是登录Shell，但nvm安装脚本只修改了~/.bashrc或~/.zshrc，而某些Shell（如zsh）可能没自动加载这些文件。
- macOS：如果用zsh（默认），确认
~/.zshrc末尾有source ~/.nvm/nvm.sh；没有就手动加一行 - Windows（nvm-windows）：安装时必须勾选“Add to PATH”，且安装路径不能含空格或中文（比如
D:\nvm可以，D:\Program Files\nvm不行） - 重启VSCode：关闭所有窗口再重开，避免缓存旧Shell环境
- 验证：在VSCode终端里直接输
nvm --version，有输出才算真正生效
VSCode调试时仍用错Node版本？项目级版本绑定要靠.nvmrc
nvm use 18.16.0只影响当前终端会话，VSCode新开终端或调试器启动时不会继承——除非你告诉它该用哪个版本。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 在项目根目录新建文件
.nvmrc，内容只有一行：18.16.0（不要带v前缀） - 确保VSCode终端已启用自动nvm切换：在VSCode设置里搜
terminal.integrated.shellArgs，Linux/macOS用户可加["--login"]让终端作为登录Shell启动 - 调试时，launch.json里不必指定
runtimeExecutable，VSCode会自动读取.nvmrc并调用对应node - 验证：在项目目录下开VSCode终端，执行
nvm current，结果应与.nvmrc一致
国内安装慢或失败？镜像源必须改settings.txt（Windows）或NVM_NODEJS_ORG_MIRROR（macOS/Linux）
官方源https://nodejs.org/dist/在国内经常超时，nvm默认不走镜像，必须手动配。
- Windows：打开
nvm安装目录\settings.txt，添加两行：node_mirror: https://npmmirror.com/mirrors/node/npm_mirror: https://npmmirror.com/mirrors/npm/ - macOS/Linux：在
~/.bashrc或~/.zshrc中添加：export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node - 旧淘宝镜像
registry.npm.taobao.org已停用，证书过期，务必换为npmmirror.com - 改完记得
source ~/.zshrc（或对应shell配置），再运行nvm install 20.3.0测试
真正麻烦的不是装nvm，而是让VSCode每次打开都“记住”你当前项目该用哪个Node版本——.nvmrc文件和Shell登录模式缺一不可。
