在 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

常见问题解决

1. 权限问题：如果遇到权限错误，可以尝试：

   sudo chown -R $(whoami) $(brew --prefix)/*
   

2. 命令未找到：确保 Homebrew 的路径已添加到你的 shell 配置文件中：

   echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
   source ~/.zshrc
   

3. 版本不匹配：如果 node 和 npm 版本显示不一致，可以尝试：

   brew postinstall node
   

通过 Homebrew 安装 Node.js 是最简单、最推荐的方式，它能自动处理依赖关系并方便后续升级管理。