macOS 下通过 Homebrew 安装 Node.js 指南
1. 准备工作
首先确保你已经安装了 Homebrew（macOS 上最流行的包管理器）：
# 检查是否已安装 Homebrew
brew --version
# 如果未安装，使用以下命令安装
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. 安装 Node.js
方法一：安装最新稳定版（推荐）
brew install node
方法二：安装特定版本
# 先搜索可用的 Node.js 版本
brew search node
# 安装特定版本（如 18.x）
brew install node@18
3. 安装后的验证
# 检查 Node.js 版本
node -v
# 检查 npm 版本
npm -v
# 检查 npx 版本
npx -v
4. 环境变量配置（仅当安装特定版本时需要）
如果你安装了特定版本的 Node.js（如 node@18），需要手动添加环境变量：
# 对于 bash/zsh 用户
echo 'export PATH="/usr/local/opt/node@18/bin:$PATH"' >> ~/.zshrc
# 然后重新加载配置文件
source ~/.zshrc
5. 升级 Node.js
# 先更新 Homebrew
brew update
# 然后升级 Node.js
brew upgrade node
6. 切换 Node.js 版本（可选）
如果你需要管理多个 Node.js 版本，可以使用 n 或 nvm：
使用 n 管理版本
# 安装 n
npm install -g n
# 安装特定版本
n 16.13.0
# 切换版本
n
使用 nvm 管理版本
# 安装 nvm
brew install nvm
# 然后按照提示配置环境变量
# 使用 nvm 安装和管理版本
nvm install 14
nvm use 14
7. 卸载 Node.js
# 卸载 Node.js
brew uninstall node
# 如果需要彻底删除残留文件
rm -rf /usr/local/lib/node_modules
rm -rf ~/.npm
常见问题解决
版本不匹配：如果 node 和 npm 版本显示不一致，可以尝试：
brew postinstall node
命令未找到：确保 Homebrew 的路径已添加到你的 shell 配置文件中：
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
权限问题：如果遇到权限错误，可以尝试：
sudo chown -R $(whoami) $(brew --prefix)/*
通过 Homebrew 安装 Node.js 是最简单、最推荐的方式，它能自动处理依赖关系并方便后续升级管理。
