Homebrew 这东西,用得好是神器,用不好是真折磨。Mac 上装软件,离不开它;但每次 brew update 卡在 GitHub 上,进度条半天不动,最后等来一堆报错,也是不少人的日常。之前我也被折腾过几轮,后来索性写了一个「Mac OS 更新 Homebrew 镜像源脚本」,一键切换国内镜像源,把 brew update 和安装瓶装包的耗时从十几分钟压到了几十秒。这篇文章就把脚本的思路、完整实现、踩坑点都摊开来讲,适合被 Homebrew 下载速度折磨过、又不想每次手动 export 环境变量的人参考。
1. 为什么需要这样一个镜像源脚本
1.1 Homebrew 慢在哪
很多新手第一次用 Homebrew,第一感受就是“装个软件怎么这么慢”。其实慢的原因并不复杂:Homebrew 的默认数据源和安装包下载地址都指向官方服务器,官方地址在国外,国内直连的时候延迟高、丢包率高,偶尔还会直接超时。你执行 brew install wget 的时候,Homebrew 会先去拉取 formula 元数据,然后再去下载对应的 bottle 二进制包,这两个环节都有可能在国外地址上卡住。
brew update 的过程更明显。它会尝试更新 Homebrew 自己的仓库、homebrew-core 仓库,还要从 formulae.brew.sh 拉取最新的 API 数据。这些请求一旦碰到网络波动,整个命令就会长时间停在“Updating Homebrew...”那一行,看起来像死机了一样。有一次我在公司网络下跑 brew update,等了差不多二十分钟还没结束,最后 Ctrl+C 放弃,去查日志才发现是卡在了一个国外 CDN 的回源请求上。
所以问题的核心不是 Homebrew 本身不好用,而是默认下载链路在国内不够友好。要解决它,最直接的办法就是切换到国内镜像源。镜像源做的事情很简单:把 Homebrew 的元数据、仓库、二进制包都同步到国内服务器上,让你从国内地址下载,速度自然就上来了。
1.2 镜像源方案对比
目前国内用得比较多的 Homebrew 镜像源有三个:清华 TUNA、中科大 USTC、阿里云。我三个都用过,简单说一下区别。
| 镜像源 | API 域名 | Bottle 域名 | 特点 |
|---|---|---|---|
| 清华 TUNA | mirrors.tuna.tsinghua.edu.cn | mirrors.tuna.tsinghua.edu.cn | 同步及时,文档全,高校网络下很快,是我最常用的 |
| 中科大 USTC | mirrors.ustc.edu.cn | mirrors.ustc.edu.cn | 速度稳定,更新也比较勤,适合教育网和联通线路 |
| 阿里云 | mirrors.aliyun.com | mirrors.aliyun.com | 商业带宽充足,某些地区运营商网络下延迟更低 |
三个镜像源都能覆盖 Homebrew 的 API 数据、仓库和 bottle 下载,日常使用哪个都不会差太多。唯一需要留意的是一段时间内的可用性和同步延迟,万一某个源出了故障,脚本能一键切换到另一个源就很关键。
手动切换镜像源其实不复杂,网上一搜教程一大堆。但问题是每次要么手动写 export,要么改 git remote,操作一多就容易漏。尤其新版 Homebrew 4.x 对 API 域名的依赖更强,很多人只改了 git remote,没改 HOMEBREW_API_DOMAIN,结果 brew install 依然慢。我写这个脚本,就是想把这一套流程封装成一条命令,顺带解决多个源之间来回切换、恢复官方源、清理重复配置这些问题。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 脚本设计思路与关键细节
2.1 设计目标
动手写脚本之前,我给自己定了几个目标,避免写着写着变成一次性工具。
第一条,必须支持多个镜像源。不能写死一个清华源,万一哪天清华源炸了,脚本就废了。所以参数要能接受 tuna、ustc、aliyun,并预留 official 用来恢复官方源。
第二条,必须能重复执行。有些脚本你跑第二遍,rc 文件里就多了一堆重复的 export,看起来非常乱。我要求脚本每次执行前先清理同名的环境变量配置,再追加新配置,保证幂等。
第三条,要同时处理环境变量和 git remote。只设置环境变量,brew update 时本地仓库的 remote 可能还指向官方地址,照样会去连官方服务器。所以脚本要自动识别 brew 安装路径,把本地 brew 仓库的 remote 也切到镜像地址。
第四条,要有容错能力。脚本执行过程中,如果 brew 命令不存在、brew 仓库路径不对,不能直接报错中断,至少得把环境变量配好,然后提示用户手动处理。
2.2 环境变量怎么配
Homebrew 的镜像切换主要靠四个环境变量:HOMEBREW_API_DOMAIN、HOMEBREW_BOTTLE_DOMAIN、HOMEBREW_BREW_GIT_REMOTE、HOMEBREW_CORE_GIT_REMOTE。
HOMEBREW_API_DOMAIN 是 Homebrew 4.x 之后非常重要的一个变量。它决定了 brew update 和 brew search 时从哪里拉取 formul
