🍺

Homebrew 镜像配置完全指南

macOS/Linux 包管理器 | Mac 用户必备

⏱️ 5分钟配置 🎯 支持 Intel 和 Apple Silicon 💻 macOS + Linux

📖 什么是 Homebrew？

Homebrew 是 macOS 和 Linux 上最流行的包管理器，被称为"macOS 缺失的软件包管理器"。通过简单的命令即可安装各种开发工具和软件。

  • 海量软件包：超过6000个软件包和应用程序
  • 简单易用：一条命令安装、更新、卸载
  • 无需权限：安装在用户目录，无需 sudo
  • 自动依赖管理：自动处理软件依赖关系
💡 为什么需要配置镜像源？

Homebrew 默认从 GitHub 和官方服务器下载，国内访问速度慢，经常超时。配置国内镜像后，下载速度可提升10-50倍！特别是安装大型软件如 Node.js、Python、MySQL 等。

🚀 快速配置（推荐）

下面的脚本会自动配置清华大学镜像源，支持 zsh 和 bash：

1. 清华大学镜像（推荐）

# 设置 Homebrew 镜像 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" export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles" # 应用配置 brew update

2. 中科大镜像

export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git" export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git" export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles" brew update

3. 阿里云镜像

export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.aliyun.com/homebrew/brew.git" export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.aliyun.com/homebrew/homebrew-core.git" export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.aliyun.com/homebrew/homebrew-bottles" brew update

⚙️ 永久配置

上述配置重启终端后会失效，需要写入配置文件：

Zsh 用户（macOS 默认）

编辑 ~/.zshrc 文件，添加：

echo 'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"' >> ~/.zshrc echo 'export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"' >> ~/.zshrc echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"' >> ~/.zshrc # 使配置生效 source ~/.zshrc

Bash 用户

编辑 ~/.bash_profile 文件：

echo 'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"' >> ~/.bash_profile echo 'export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"' >> ~/.bash_profile echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"' >> ~/.bash_profile source ~/.bash_profile

🍎 Apple Silicon (M1/M2/M3) 专属配置

Apple Silicon 芯片的 Mac 需要额外注意：

检查 Homebrew 安装位置

which brew # Intel Mac: /usr/local/bin/brew # Apple Silicon: /opt/homebrew/bin/brew

Apple Silicon 完整配置

# 添加到 ~/.zshrc echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc echo 'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"' >> ~/.zshrc echo 'export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"' >> ~/.zshrc echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"' >> ~/.zshrc echo 'export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"' >> ~/.zshrc source ~/.zshrc

🔄 恢复官方源

如果需要切换回官方源：

# 取消环境变量设置 unset HOMEBREW_BREW_GIT_REMOTE unset HOMEBREW_CORE_GIT_REMOTE unset HOMEBREW_BOTTLE_DOMAIN unset HOMEBREW_API_DOMAIN # 重置 Homebrew brew update-reset # 从 ~/.zshrc 或 ~/.bash_profile 中删除相关配置行

🔧 常用镜像源对比

镜像源 速度 稳定性 推荐度
清华大学 ⚡⚡⚡⚡⚡ ⭐⭐⭐⭐⭐ ✅ 首选
中科大 ⚡⚡⚡⚡⚡ ⭐⭐⭐⭐⭐ ✅ 首选
阿里云 ⚡⚡⚡⚡ ⭐⭐⭐⭐ ✅ 推荐

❓ 常见问题

Q1: brew update 还是很慢怎么办？

解决方案：

  • 确认配置生效：echo $HOMEBREW_BOTTLE_DOMAIN
  • 清除缓存：rm -rf "$(brew --cache)"
  • 禁用自动更新：export HOMEBREW_NO_AUTO_UPDATE=1
  • 尝试更换其他镜像源

Q2: 提示 "Error: Checksum mismatch"

解决方案：

  • 镜像同步延迟，等待10-30分钟后重试
  • 清除缓存：brew cleanup
  • 临时切换回官方源下载该包

Q3: brew install 失败提示权限问题

解决方案：

# 修复 Homebrew 目录权限 sudo chown -R $(whoami) $(brew --prefix)/* # 或重新安装 Homebrew /bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

Q4: 如何加速 Homebrew Cask 安装？

Cask 安装的应用程序（如 Chrome、VSCode）也可以加速：

# 配置 Cask 镜像 export HOMEBREW_CASK_OPTS="--appdir=/Applications --fontdir=/Library/Fonts" # 某些 Cask 需要翻墙，可以使用代理 export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"

🎓 高级技巧

1. 禁用自动更新

每次安装都会自动更新，可以禁用：

echo 'export HOMEBREW_NO_AUTO_UPDATE=1' >> ~/.zshrc

2. 查看已安装的包

# 列出所有安装的包 brew list # 查看包的详细信息 brew info package-name # 查看过时的包 brew outdated

3. 清理旧版本

# 清理所有旧版本 brew cleanup # 查看可以清理的内容 brew cleanup -n # 清理缓存 rm -rf "$(brew --cache)"

4. 诊断问题

# Homebrew 自检 brew doctor # 查看配置 brew config

📦 常用 Homebrew 命令速查

# 搜索软件包 brew search keyword # 安装软件包 brew install package-name # 卸载软件包 brew uninstall package-name # 更新 Homebrew brew update # 更新所有软件包 brew upgrade # 查看已安装的包 brew list # 查看包信息 brew info package-name # 清理旧版本 brew cleanup # 查看服务 brew services list

✨ 最佳实践

✅ Homebrew 使用建议
  1. 定期更新：brew update && brew upgrade
  2. 定期清理：brew cleanup 释放磁盘空间
  3. 使用 Bundle：用 Brewfile 管理所有软件包
  4. 避免 sudo：Homebrew 不应使用 sudo 安装
  5. 备份 Brewfile：brew bundle dump

🔗 相关资源

💡 配置成功了吗？

如果这篇教程对你有帮助，欢迎分享给其他 Mac 用户！遇到问题可以到 关于页面 反馈。