brew install 很慢的解决方法

Homebrew 加速指南

brew install 慢可能发生在更新元数据、下载预编译包，或下载软件自己的安装文件时。可以先临时配置镜像，确认有效后再保存设置。

1. 临时使用中科大镜像

以下命令适用于 macOS 的 zsh，只影响当前终端。设置预编译包与 API 镜像后，再尝试安装所需软件：

export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"
brew install wget

这里用 wget 作为示例，可替换为你实际需要的软件名。镜像无法覆盖所有软件厂商的下载地址，效果取决于具体下载环节。

配置依据：中科大 Homebrew Bottles 帮助。该站也提供试验中的 OCI 配置，使用前请查看其最新说明。

2. 保存常用配置

确认上一步有效后，编辑 ~/.zshrc，加入下面两行；如果已经存在同名设置，修改原有行即可，不要反复追加：

export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"

然后在终端重新加载：

source ~/.zshrc
brew update

使用 bash 时，请按自己的终端启动方式编辑对应的配置文件。

3. Homebrew 自身更新缓慢

先查看当前仓库地址并记下原值，以便恢复：

git -C "$(brew --repo)" remote get-url origin

需要使用中科大的 Homebrew 仓库镜像时：

git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git
brew update

参考：中科大 Homebrew 仓库帮助。普通安装可以先使用 API 镜像，无需为了换源额外克隆 core、cask 仓库。

4. 临时代理和诊断

如果已经有本地 HTTP 代理，可只对一次安装指定代理。下面的 7890 需要与自己的代理端口一致：

https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890 brew install wget

遇到配置问题时，查看诊断信息：

brew doctor

仅本次安装需要跳过自动更新时，可以使用：

HOMEBREW_NO_AUTO_UPDATE=1 brew install wget

不要把跳过更新当作长期加速方案；应继续定期检查软件更新。

5. 恢复默认来源

如果修改过 Homebrew 仓库地址，可恢复官方地址：

git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew.git

在 ~/.zshrc 中删除之前添加的镜像设置，并清除当前终端里的对应变量：

unset HOMEBREW_BOTTLE_DOMAIN HOMEBREW_API_DOMAIN
source ~/.zshrc
brew update

如果另行设置过 HOMEBREW_ARTIFACT_DOMAIN，也需要移除该配置。若是要恢复自己原先的私有镜像，请使用第 3 步记录的地址。