Mac 上应优先安装 nvm 再管理 Node 版本，避免直接安装包或 Homebrew 装 Node 导致单版本锁定；官方脚本安装 nvm 后，可用 nvm install/use/list 等命令灵活切换多版本，并通过 .nvmrc 实现项目自动匹配，同时建议配置 npm 全局路径至用户目录规避权限问题。

mac 上装 node.js，别直接下安装包或用 homebrew 装 node，那样只能固定一个版本，项目一换就报错。真正靠谱的做法是先装 nvm，再用它管所有 node 版本——干净、灵活、不碰系统、项目之间互不干扰。

nvm 安装（官方脚本，推荐）

打开终端，一行命令搞定：

• 执行安装脚本：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
• 加载环境（无需重启终端）：source ~/.zshrc（macOS 默认用 zsh）
• 验证是否成功：nvm -v，输出类似 0.40.4 即表示装好了

安装和切换 Node 版本

nvm 装好后，Node 版本管理就是几条命令的事：

Rydberg Agent Node

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

下载

• 查可用版本（比如看 LTS）：nvm list-remote --lts
• 装常用版本：nvm install 18.19.0 或 nvm install --lts（最新长期支持版）
• 查看已装版本：nvm list，带 -> 的是当前正在用的
• 临时切换（仅当前终端）：nvm use 20.12.0
• 设为默认（新开终端自动生效）：nvm alias default 18.19.0

让项目自动匹配 Node 版本

不用每次进项目都手动 nvm use，加个配置文件就行：

• 在项目根目录新建 .nvmrc 文件，内容只写一行，比如：16.20.2
• 进入项目目录后运行 nvm use（不带参数），nvm 就会自动读取并切换
• 如需“cd 进目录就自动切”，可在 ~/.zshrc 中添加 shell hook（需要时可提供）

避免 npm 全局安装权限问题

npm 全局装东西（比如 pnpm、create-vue）容易报 EACCES 错，根源是路径权限不对。解决方法是把全局目录挪到用户目录下：

• 创建专属目录：mkdir ~/.npm-global
• 告诉 npm 用这个目录：npm config set prefix '~/.npm-global'
• 把该目录加进 PATH（追加到 ~/.zshrc）：export PATH=~/.npm-global/bin:$PATH
• 重载配置：source ~/.zshrc