Mac系统下Node版本管理工具对比与使用指南

在 Mac 开发环境中，不同项目对 Node 版本的要求可能不同。本文对比三种主流工具（nvm、n、fnm）的安装、版本切换及使用场景，帮助开发者选择最适合的方案。

工具对比与选择

工具	优点	缺点	适用场景
nvm	功能全面，支持多版本隔离	安装稍复杂，需配置 Shell	需要精细控制版本和全局模块
n	安装简单，命令直观	无法隔离全局模块，功能较少	追求简单快速切换
fnm	速度快，支持自动切换项目版本	社区相对较小，文档较少	喜欢现代化工具且需要自动切换

nvm 使用详解

安装与配置

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.zshrc  # 或 source ~/.bashrc

版本管理

nvm install 18.0.0      # 安装指定版本
nvm use 18.0.0          # 临时切换（当前终端有效）
nvm alias default 18.0.0 # 永久切换（全局生效）
nvm list                # 查看已安装版本
nvm uninstall 18.0.0    # 卸载版本

注意：若切换后重启终端失效，需检查 ~/.zshrc 或 ~/.bashrc 是否包含 nvm 初始化脚本。

n 工具使用指南

安装与基础操作

sudo npm install -g n    # 全局安装n工具
sudo n 18.0.0           # 安装并切换版本
n                        # 交互式选择版本
n list                   # 查看已安装版本
n rm 16.13.2            # 删除版本

局限：所有版本共享全局模块，可能导致版本冲突。

fnm 快速入门

安装与配置

curl -fsSL https://fnm.vercel.app/install | bash
eval "$(fnm env --use-on-cd)" >> ~/.zshrc  # 自动切换配置

版本控制

fnm install 18.0.0      # 安装版本
fnm use 18.0.0          # 临时切换
fnm default 18.0.0      # 永久切换
fnm ls                  # 查看版本列表

优势：支持 .node-version 或 .nvmrc 文件自动切换版本。

常见问题解决

nvm 切换后重启终端失效

原因：未设置默认版本或 Shell 未加载 nvm 脚本。

方案：

nvm alias default 18.0.0  # 设置默认版本
echo 'source ~/.nvm/nvm.sh' >> ~/.zshrc  # 确保加载nvm

n 工具无法隔离全局模块

建议：对模块隔离要求高的项目优先使用 nvm 或 fnm。