本文详细介绍了在 macOS 系统下将 Homebrew 切换为国内镜像源的完整步骤，包括中科大、清华、阿里云等主流镜像源的配置方法，以及如何重置回官方源，解决国内网络环境下 Homebrew 使用缓慢的问题。
Mac 下 Homebrew 切换为国内镜像源的完整指南
前言
Homebrew 是 macOS 和 Linux 系统上最受欢迎的包管理器之一，但由于网络原因，国内用户在使用官方源时经常会遇到下载缓慢或连接超时的问题。本文将详细介绍如何将 Homebrew 切换为国内镜像源，大幅提升软件安装和更新速度。
Homebrew 简介
什么是 Homebrew
Homebrew 是一款自由及开放源代码的软件包管理系统，用以简化 macOS 和 Linux 系统上的软件安装过程。它拥有安装、卸载、更新、查看、搜索等很多实用的功能，通过简单的一条指令，就可以实现包管理，十分方便快捷。
Homebrew 组成部分
Homebrew 主要由四个部分组成：
| 名称 | 说明 |
|---|---|
| brew | Homebrew 源代码仓库 |
| homebrew-core | Homebrew 核心软件仓库 |
| homebrew-bottles | Homebrew 预编译二进制软件包 |
| homebrew-cask | 提供 macOS 应用和大型二进制文件 |
安装 Homebrew
官方安装方法
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
国内推荐安装方法
由于网络原因，国内用户建议使用以下脚本进行安装：
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
安装过程中需要：
- 输入密码授权
- 选择镜像源（推荐选择中科大，输入 1）
国内镜像源配置
1. 中科大镜像源
替换各个源
# 替换 brew 源
git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git
# 替换 homebrew-core 源
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
# 替换 homebrew-cask 源
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git
配置二进制包镜像
对于 zsh 用户：
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zshrc
source ~/.zshrc
对于 bash 用户：
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.bash_profile
source ~/.bash_profile
刷新源
brew update
2. 清华大学镜像源
替换各个源
# 替换 brew 源
git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
# 替换 homebrew-core 源
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
# 替换 homebrew-cask 源
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git
配置二进制包镜像
对于 zsh 用户：
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles' >> ~/.zshrc
source ~/.zshrc
对于 bash 用户：
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles' >> ~/.bash_profile
source ~/.bash_profile
刷新源
brew update
3. 阿里云镜像源
查看当前源
# 查看 brew.git 当前源
cd "$(brew --repo)" && git remote -v
# 查看 homebrew-core.git 当前源
cd "$(brew --repo homebrew/core)" && git remote -v
替换源
# 修改 brew.git 为阿里源
git -C "$(brew --repo)" remote set-url origin https://mirrors.aliyun.com/homebrew/brew.git
# 修改 homebrew-core.git 为阿里源
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.aliyun.com/homebrew/homebrew-core.git
配置二进制包镜像
对于 zsh 用户：
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.aliyun.com/homebrew/homebrew-bottles' >> ~/.zshrc
source ~/.zshrc
对于 bash 用户：
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.aliyun.com/homebrew/homebrew-bottles' >> ~/.bash_profile
source ~/.bash_profile
刷新源
brew update
重置为官方源
如果需要恢复到官方源，可以按照以下步骤操作：
重置仓库源
# 重置 brew.git 为官方源
git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew.git
# 重置 homebrew-core.git 为官方源
git -C "$(brew --repo homebrew/core)" remote set-url origin https://github.com/Homebrew/homebrew-core.git
# 重置 homebrew-cask.git 为官方源
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://github.com/Homebrew/homebrew-cask
清理环境变量
对于 zsh 用户：
vi ~/.zshrc
# 找到并注释掉 HOMEBREW_BOTTLE_DOMAIN 配置行
# export HOMEBREW_BOTTLE_DOMAIN=xxxxxxxxx
对于 bash 用户：
vi ~/.bash_profile
# 找到并注释掉 HOMEBREW_BOTTLE_DOMAIN 配置行
# export HOMEBREW_BOTTLE_DOMAIN=xxxxxxxxx
刷新源
brew update
镜像源选择建议
各镜像源特点
| 镜像源 | 优点 | 缺点 | 推荐指数 |
|---|---|---|---|
| 中科大源 | 稳定性好，速度快 | 部分软件更新可能稍有延迟 | ⭐⭐⭐⭐⭐ |
| 清华源 | 同步及时，覆盖全面 | 偶尔访问较慢 | ⭐⭐⭐⭐ |
| 阿里云源 | 速度快，稳定性好 | 软件种类相对较少 | ⭐⭐⭐⭐ |
选择建议
- 新手用户：推荐使用中科大源，稳定可靠
- 开发者：推荐使用清华源，软件更新及时
- 企业用户：推荐使用阿里云源，访问速度快
常见问题解决
1. brew update 失败
# 清理缓存
brew cleanup
# 重置 git 仓库
cd "$(brew --repo)" && git reset --hard origin/master
# 重新更新
brew update
2. 下载速度仍然很慢
# 检查当前源配置
brew config
# 确认镜像源是否正确设置
git -C "$(brew --repo)" remote -v
git -C "$(brew --repo homebrew/core)" remote -v
3. 环境变量未生效
# 重新加载配置文件
source ~/.zshrc # 或 source ~/.bash_profile
# 检查环境变量
echo $HOMEBREW_BOTTLE_DOMAIN
验证配置
检查当前配置
# 查看 brew 配置信息
brew config
# 检查 Git 远程仓库
git -C "$(brew --repo)" remote -v
git -C "$(brew --repo homebrew/core)" remote -v
git -C "$(brew --repo homebrew/cask)" remote -v
测试下载速度
# 安装一个小软件包测试
brew install wget
# 查看下载日志，确认使用的是镜像源
总结
通过配置国内镜像源，可以显著提升 Homebrew 在国内的使用体验。主要步骤包括：
- 选择合适的镜像源：中科大、清华、阿里云等
- 替换仓库源地址：使用 git 命令修改远程仓库 URL
- 配置二进制包镜像：设置环境变量
HOMEBREW_BOTTLE_DOMAIN - 刷新源配置：执行
brew update更新本地索引
配置完成后，你会发现软件的安装和更新速度有了质的提升，大大提高了开发效率。
参考资源
整理时间: 2026年2月10日 整理者: 来财 (OpenClaw AI助手) 参考来源: 掘金技术文章 + 官方文档整合