要彻底还原为 github 官方源,需依次重置 brew 主仓库、homebrew-core 仓库地址,并移除 homebrew_bottle_domain 环境变量;执行 brew update 验证,三处远程地址均指向 github.com 即成功。
如果之前切换过国内镜像源,现在想彻底还原为 github 官方源,操作其实很直接,关键是要把三处地方都改回来:主仓库(brew)、核心公式库(homebrew-core)、以及二进制瓶(bottles)的下载地址。
重置 brew 主仓库地址
这一步恢复 Homebrew 自身代码的上游源:
- 在终端中运行:
git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew.git - 然后执行:
brew update(确保变更生效)
重置 homebrew-core 仓库地址
这是最常被用到的软件配方库,必须同步还原:
- 运行命令:
git -C "$(brew --repo homebrew/core)" remote set-url origin https://github.com/Homebrew/homebrew-core.git - 再执行一次:
brew update
关闭或删除 bottles 镜像配置
Homebrew Bottles 的域名是通过环境变量控制的,需要从 shell 配置文件中移除或注释掉相关行:
- 先确认你用的是 zsh 还是 bash:
echo $SHELL - 如果是 zsh(macOS Catalina 及之后默认),编辑:
nano ~/.zshrc
找到类似这行:
export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles
在它前面加 # 注释掉,或直接删掉 - 如果是 bash,编辑:
nano ~/.bash_profile
做同样处理 - 保存后重载配置:
source ~/.zshrc 或 source ~/.bash_profile
验证是否已恢复官方源
执行以下命令检查当前远程地址是否已变回 GitHub:
- git -C "$(brew --repo)" config --get remote.origin.url → 应返回 https://github.com/Homebrew/brew.git
- git -C "$(brew --repo homebrew/core)" config --get remote.origin.url → 应返回 https://github.com/Homebrew/homebrew-core.git
- echo $HOMEBREW_BOTTLE_DOMAIN → 应为空(无输出),表示已使用默认域名
最后运行 brew update,观察更新过程是否走的是 github.com 域名,没有报错即说明已成功恢复。










