直接换清华源可将Homebrew的update和install速度从几十KB/s提升至5–15MB/s,需同步配置主仓库、homebrew-core、homebrew-cask三处Git远程地址及HOMEBREW_BOTTLE_DOMAIN环境变量,缺一不可。
直接换清华源能让 homebrew 的 update 和 install 速度从几十 kb/s 提升到 5–15 mb/s,基本秒响应。关键不是“能不能换”,而是换对位置——homebrew 有三个核心部分需要同步配置:主仓库(brew)、公式库(homebrew-core)、应用库(homebrew-cask),缺一不可。
确认当前源地址
先看看你现在用的是不是 GitHub 官方源:
- 终端运行:
git -C "$(brew --repo)" remote -v→ 查主仓库源 - 再运行:
git -C "$(brew --repo homebrew/core)" remote -v→ 查 formula 源 - 最后运行:
git -C "$(brew --repo homebrew/cask)" remote -v→ 查 cask 源
如果三处都显示 https://github.com/Homebrew/xxx,就说明还没换源,可以继续下一步。
一键替换为清华镜像源(推荐)
复制粘贴以下四行命令,逐行执行(M1/M2/M3/M4 和 Intel 均适用):
git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.gitgit -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.gitgit -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.gitecho 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles' >> ~/.zshrc && source ~/.zshrc
第四行是关键:它把二进制包(bottle)的下载地址也指向清华镜像,避免 brew install 时仍走海外 CDN。
验证是否生效
执行以下两步检查:
-
brew update—— 正常应在 5 秒内完成,无报错即成功 -
brew install wget—— 观察下载速度,若显示Downloading https://mirrors.tuna.tsinghua.edu.cn/...且速度达 MB 级,说明全部生效
如果某一步卡住或报 Permission denied,大概率是本地 Git 仓库权限异常,可运行 sudo chown -R $(whoami) $(brew --repo) 修复。
后续使用小提醒
清华源每月同步一次核心仓库,日常使用完全够用。但如果你刚换源后发现某个新软件装不上(比如提示 No available formula or cask),别急着切回官方源——先运行 brew update 再试一次,多数情况是缓存未刷新所致。

















