要恢复 homebrew 官方源,需依次将 brew 主仓库、homebrew-core、homebrew-cask 的 git origin 地址重设为对应 github 官方地址,并可选清理 homebrew_bottle_domain 等环境变量,最后执行 brew update 即可。
如果之前替换了 homebrew 的国内镜像源(比如清华、中科大),现在想恢复成官方 github 源,操作很明确:只需要把四个关键 git 远程仓库的 origin 地址重新设回对应的 github 官方地址,并执行 brew update 即可。
恢复 brew 主仓库源
这是 Homebrew 自身代码所在的仓库,控制命令行工具行为:
- 运行:
cd "$(brew --repo)" - 再运行:
git remote set-url origin https://github.com/Homebrew/brew.git
恢复 homebrew-core 源
这个仓库包含绝大多数命令行软件(如 git、wget、python)的安装规则(Formula):
- 运行:
cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core" - 再运行:
git remote set-url origin https://github.com/Homebrew/homebrew-core.git
恢复 homebrew-cask 源
这个仓库管理图形界面应用(如 VS Code、Chrome)的安装逻辑(Cask):
- 运行:
cd "$(brew --repo)/Library/Taps/homebrew/homebrew-cask" - 再运行:
git remote set-url origin https://github.com/Homebrew/homebrew-cask.git
检查并清理 bottles 相关环境变量(可选)
Homebrew bottles(预编译二进制包)本身不依赖 Git,但如果你曾手动设置过 HOMEBREW_BOTTLE_DOMAIN 等变量(例如指向镜像站),建议检查并清除:
- 运行:
env | grep HOMEBREW查看是否设置了相关变量 - 若存在,可在
~/.zprofile(Apple Silicon)或~/.zshrc(Intel 或自定义 shell)中删除对应export HOMEBREW_...行 - 然后运行:
source ~/.zprofile(或对应配置文件)使更改生效
全部执行完后,运行 brew update。你会看到它开始从 GitHub 拉取更新,说明已成功切回官方源。











