在 macos 中用 nvm 配置多版本 node.js 环境，需安装 nvm 并配置 ~/.zshrc、设置国内镜像源、安装常用版本并设默认值、通过 .nvmrc 实现项目级自动切换。

在 macos 中配置支持多版本切换的 node.js 开发环境，核心是用 nvm（node version manager）替代单一安装方式。它不修改系统 node，所有版本独立存于用户目录，切换快、隔离强、项目级自动识别也稳定。

安装 nvm 并注入 shell 环境

nvm 本身不是系统包，需手动安装并确保每次新开终端都能调用。macOS 默认用 zsh，所以重点配 ~/.zshrc：

• 运行安装命令：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
• 检查 ~/.zshrc 是否已自动写入初始化代码；若没有，手动追加两行：
  export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
• 执行 source ~/.zshrc 生效，再运行 nvm --version 验证

配置国内镜像源加速安装

官方 Node 下载源在国外，直连常卡在 “Downloading and installing node” 阶段。设为国内镜像可避免超时和中断：

Rydberg Agent Node

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

下载

• 设置 Node 镜像：nvm node_mirror https://npmmirror.com/mirrors/node/
• 设置 npm 镜像（后续全局安装包也提速）：nvm npm_mirror https://npmmirror.com/mirrors/npm/
• 运行 nvm get mirror 确认两个地址都已显示

安装常用版本并设默认值

装好 nvm 后，Node 版本按需下载，互不覆盖。推荐至少装一个 LTS 和一个当前活跃版：

• 查看可选版本：nvm list-remote（或简写 nvm ls-remote）
• 安装 LTS 版（如 v18.19.1）：nvm install 18.19.1
  安装最新稳定版：nvm install node
• 设 LTS 为新终端默认版本：nvm alias default 18.19.1
• 新开终端后，直接运行 node -v 应输出该版本号

实现项目级自动版本切换

不同项目依赖不同 Node 版本时，不用每次 cd 进去手动 nvm use。靠 .nvmrc 文件即可自动识别：

• 进入项目根目录，创建文件：echo "18.19.1" > .nvmrc
• 退出再进入该目录，运行 nvm use（或直接 cd . 触发重载）
• 也可启用自动切换：在 ~/.zshrc 末尾加一行
  alias cd="cd; nvm use 2>/dev/null || true"（谨慎使用，可能影响其他脚本）