nvm是vscode中管理node版本唯一可靠方案，因其终端、调试器、任务系统不加载shell初始化文件导致环境变量失效；需手动配置terminal.integrated.env.zsh或启用inheritenv，且每次nvm use后须重启集成终端并显式配置runtimeexecutable。

nvm 是唯一靠谱的方案，其他方式在 VSCode 里基本不可靠。 直接改系统 PATH 或手动切换安装目录，VSCode 集成终端、调试器、任务系统全都不认账——不是配置没生效，而是它们根本不走同一套环境加载逻辑。

VSCode 终端里 nvm 命令找不到

这不是 nvm 没装好，也不是 VSCode 插件问题，而是 VSCode 启动时压根没加载你的 shell 初始化文件（比如 ~/.zshrc 或 ~/.bash_profile），所以 nvm 不在 PATH 里。

• Mac/Linux：在 VSCode 设置中搜 terminal.integrated.env.zsh（或对应 shell），手动加两行：
  "PATH":"/Users/you/.nvm/bin:${env:PATH}"
"NVM_DIR":"/Users/you/.nvm"
• 更省事的办法：把 terminal.integrated.inheritEnv 设为 true，让终端直接继承系统 shell 环境
• 改完必须彻底退出所有 VSCode 窗口，再从终端执行 code --no-sandbox . 启动——用 Developer: Reload Window 不管用，进程环境不会刷新
• 验证：新开集成终端，运行 which nvm，能输出路径才算成功

nvm use 切了版本，但 node -v 还是旧的

常见于你已经在 VSCode 里打开了终端，然后才执行 nvm use 18.17.0——当前 shell 进程的 PATH 没变，VSCode 的调试器、ESLint、TypeScript 服务这些后台进程更不会跟着更新。

Rydberg Agent Node

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

下载

• 每次 nvm use 后，必须关闭并重新打开 VSCode 集成终端
• 检查 which node 输出是否指向 ~/.nvm/versions/node/v18.17.0/bin/node，而不是 /usr/bin/node
• 如果用 Run Task 或 Debug，别指望它自动读 PATH；在 .vscode/tasks.json 或 launch.json 中显式写死：
  "runtimeExecutable": "${env:NVM_BIN}/node"

项目根目录的 .nvmrc 文件被无视

VSCode 本身完全不感知 .nvmrc，它只是个文本文件。nvm 默认也不会自动读它，除非你手动触发或启用 auto-use。

• .nvmrc 内容只写一行，比如：
  18.17.0
• 全局启用自动切换：
  nvm alias default 18.17.0，再执行一次 nvm use，它会提示你是否设置 alias
• 更稳妥的做法：把 nvm use 加进项目级 shell 钩子，比如用 direnv 或在 ~/.zshrc 里加检测逻辑
• 注意：.nvmrc 只影响当前 shell，VSCode 的格式化、保存钩子等 GUI 功能不走终端，所以仍依赖终端环境正确

最易被忽略的点是：VSCode 的「调试」和「任务」默认不继承终端环境变量，哪怕你 node -v 在终端里已经对了，launch.json 里没配 runtimeExecutable，照样报 Cannot find runtime 'node'——这不是 bug，是设计如此。