在 Mac 上构建 Node.js 多版本开发环境
在 Mac 上管理 Node.js 版本,Homebrew + NVM是目前最主流且被社区推荐的组合。Homebrew 作为 macOS 上的包管理器,能让你像在 Linux 上一样优雅地安装软件;而 NVM(Node Version Manager)则是专门为 Node.js 设计的版本管理工具,让你可以在不同项目间无缝切换 Node 版本。
1. 基础准备:理解你的 Shell 与 Homebrew 生态
在动手安装任何东西之前,我们先花点时间搞清楚两个核心概念:Shell和Homebrew。
1.1 你的终端环境:Zsh 与配置文件
从 macOS Catalina(10.15)开始,苹果将默认的 Shell 从 Bash 切换到了 Zsh。你可以在终端里输入 echo $SHELL 来确认:
echo $SHELL
如果返回 /bin/zsh,那么恭喜,你用的是现代 macOS 的标准配置。Zsh 比 Bash 更强大,有更好的自动补全和主题支持,但它的配置文件位置和 Bash 不同。
注意:Zsh 的配置文件是
~/.zshrc(位于你的用户主目录下),而 Bash 用的是~/.bashrc或~/.bash_profile。所有环境变量的配置、别名设置、软件路径的添加,都需要写入这个文件,然后通过source ~/.zshrc命令让配置立即生效,或者新开一个终端窗口。
你可以用以下命令快速查看或编辑这个文件:
# 查看.zshrc 内容
cat ~/.zshrc
# 使用 nano 编辑器编辑(适合新手)
nano ~/.zshrc
# 使用 VS Code 编辑(如果你已安装)
code ~/.zshrc
如果这个文件不存在,别担心,当你第一次往里面写入内容时,系统会自动创建它。
1.2 Homebrew:macOS 的包管理神器
Homebrew 的核心哲学是'安装 Apple 没有预装但你需要的东西'。它把软件包(Formula)安装到独立的 /opt/homebrew 目录(Apple Silicon 芯片)或 /usr/local 目录(Intel 芯片),不会污染系统自带的 /usr/bin,卸载也干净彻底。
检查是否已安装 Homebrew:
brew --version
如果显示版本号(如 Homebrew 4.x.x),说明已经安装。如果提示 command not found: brew,则需要安装。
安装 Homebrew(官方脚本,可能需要科学上网环境;如果慢,可以用国内镜像源):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
对于 Apple Silicon Mac(M1/M2/M3 芯片),安装完成后,终端会提示你需要将 Homebrew 路径添加到环境变量。请严格按照提示执行这两条命令,它们会把必要的配置添加到你的 ~/.zshrc 文件中。

