nvm是macOS管理多版本Node.js最稳妥主流方案，所有版本独立存放用户目录、切换干净、项目隔离，并支持.nvmrc自动匹配版本；推荐官方脚本或Homebrew安装，再配置环境变量、安装切换版本及统一npm全局路径。

在 macos 上管理多个 node.js 版本，nvm 是最稳妥、最主流的选择。它不碰系统自带的 node，所有版本都装在你自己的用户目录下，切换干净，项目之间互不干扰，还能自动匹配项目所需版本。

安装 nvm（推荐两种方式）

多数人用官方脚本安装，稳定且直接；新手或希望省心可选 Homebrew 安装。

• 官方脚本（通用推荐）：打开终端，运行
  curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
  安装完成后执行 source ~/.zshrc（macOS 默认 shell 是 zsh）
• Homebrew 方式（适合已有 brew 的用户）：
  brew install nvm
  然后创建目录并写入配置：
  mkdir ~/.nvm
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.zshrc
  最后同样执行 source ~/.zshrc

验证是否成功：nvm --version 输出类似 0.40.4 即表示安装完成。

安装与切换多个 Node.js 版本

nvm 装完，Node 版本管理就变成几条命令的事：

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

让项目自动匹配 Node 版本（实用技巧）

避免每次进项目都手动 nvm use，可在项目根目录加一个 .nvmrc 文件，内容只写一行版本号，比如：

macOS Notes

通过 AppleScript 创建、读取、搜索及管理 macOS 备忘录。适用于用户要求记笔记、记录事项、保存想法、创建会议记录等场景。

下载

16.20.2

然后进入该目录后运行 nvm use（不带参数），nvm 就会自动读取并切换。如需“cd 进目录就自动切”，可在 ~/.zshrc 中添加一段 shell hook（需要时可提供）。

避开权限和路径常见问题

npm 全局安装（如 pnpm、vue-cli）容易因权限报错。建议统一配到用户目录：

• 创建目录：mkdir ~/.npm-global
• 配置 npm 使用该目录：npm config set prefix '~/.npm-global'
• 把该目录加入 PATH（在 ~/.zshrc 中追加）：
  export PATH=~/.npm-global/bin:$PATH
• 最后重载：source ~/.zshrc

这样后续全局安装就不再需要 sudo，也不会污染系统路径。