1. Mac 安装 Homebrew 完整指南
Homebrew 是 macOS 上最受欢迎的包管理器，它让安装、更新和管理软件变得异常简单。作为一名长期使用 Mac 的开发人员，我几乎每天都会用到 brew 命令。下面分享我在不同网络环境下安装 Homebrew 的经验，包括国内镜像源的配置技巧。
1.1 安装前的准备工作
在开始安装前，建议先检查你的系统环境：
- macOS 版本需在 10.13 (High Sierra) 或更高
- 确保已安装 Xcode 命令行工具（运行
xcode-select --install） - 终端需要使用 bash 或 zsh（Catalina 及以上版本默认使用 zsh）
重要提示：如果之前安装失败过，建议先执行
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"彻底清理旧版本
1.2 官方安装方法（适合网络环境好的用户）
最直接的安装方式是使用官方脚本：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"这个命令会：
- 自动检测系统环境
- 在 /usr/local 目录创建 Homebrew 所需文件结构
- 将 brew 添加到你的 PATH 环境变量
安装完成后，建议运行brew doctor检查是否有潜在问题。
1.3 国内镜像安装方案（解决下载慢问题）
由于 GitHub 在国内访问不稳定，可以使用清华镜像源加速安装：
# 先设置环境变量 export HOMEBREW_INSTALL_FROM_API=1 export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api" export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles" export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git" export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git" # 执行安装 /bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/Homebrew/install@HEAD/install.sh)"安装完成后，还需要配置镜像源：
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles' >> ~/.zshrc brew update2. Homebrew 基本操作与维护
2.1 常用命令速查表
| 命令 | 功能描述 | 使用示例 |
|---|---|---|
| brew install | 安装软件包 | brew install wget |
| brew uninstall | 卸载软件包 | brew uninstall node |
| brew search | 搜索软件包 | brew search python |
| brew list | 列出已安装的包 | brew list --versions |
| brew update | 更新 Homebrew 自身 | brew update |
| brew upgrade | 升级所有已安装的包 | brew upgrade |
| brew cleanup | 清理旧版本 | brew cleanup -n(预览) |
| brew doctor | 诊断问题 | brew doctor |
2.2 管理不同软件类型
Homebrew 可以管理两种类型的软件：
Formula：命令行工具和库（如 node, python）
brew install nodeCask：图形界面应用程序（如 visual-studio-code）
brew install --cask visual-studio-code
2.3 解决常见问题
问题1：安装时出现 Permission denied解决方案：
sudo chown -R $(whoami) /usr/local/*问题2：更新时出现 Error: Fetching /usr/local/Homebrew failed解决方案：
cd /usr/local/Homebrew && git fetch --unshallow问题3：brew 命令找不到解决方案：将以下内容添加到 ~/.zshrc 或 ~/.bash_profile
export PATH=/opt/homebrew/bin:$PATH3. 通过 Homebrew 安装 pnpm
3.1 为什么选择 pnpm
pnpm 是比 npm 和 yarn 更高效的 Node.js 包管理器，优势在于：
- 节省磁盘空间（所有项目共享依赖）
- 安装速度更快
- 严格的 node_modules 结构避免幽灵依赖
3.2 安装步骤
首先确保已安装 Node.js（可通过 brew 安装）：
brew install node安装 pnpm：
brew install pnpm验证安装：
pnpm --version
3.3 配置国内镜像加速
pnpm 默认源在国内可能较慢，可以切换为淘宝镜像：
pnpm config set registry https://registry.npmmirror.com/3.4 pnpm 基本使用
| 命令 | 等效 npm 命令 | 功能 |
|---|---|---|
| pnpm install | npm install | 安装依赖 |
| pnpm add | npm install | 添加依赖 |
| pnpm run |
