Homebrew在macOS上变慢的根本原因是默认访问的三个国外地址(raw.githubusercontent.com、GitHub、ghcr.io)在国内连通性差;必须同步将brew本体、homebrew-core、homebrew-bottles及API域名全部切换为国内镜像源,并按芯片架构(arm64/Intel)区分路径和配置,才能彻底解决卡顿问题。
homebrew 在 macos 上变慢,根本不是 brew 本身的问题,而是它默认连的三个国外地址在国内访问困难:安装脚本(raw.githubusercontent.com)、核心仓库(github)、预编译包(ghcr.io)。优化速度的关键,是把这三处都换成国内镜像源,并确保适配你的芯片类型(intel 或 apple silicon)。
确认芯片架构再操作
不同芯片的安装路径和配置位置不同,错用会导致命令失效:
- 终端运行 uname -m,显示 arm64 → 是 M 系列芯片(M1/M2/M3/M4),brew 默认装在 /opt/homebrew
- 显示 x86_64 → 是 Intel 芯片,brew 默认装在 /usr/local
后续所有 git remote 设置、环境变量、路径引用,都要按这个区分,不能混用。
一次性换掉三个关键源
只换其中一个(比如只改 core 仓库),其他环节仍会卡住。必须同步处理:
-
brew 本体仓库:替换命令行工具本身的 Git 地址
执行:git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git -
homebrew-core 公式库:影响 brew install 大部分命令行工具
执行:git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git -
homebrew-bottles 预编译包:决定下载 node、python 等二进制包的速度
执行:export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
中科大(USTC)镜像同步及时、稳定性高,推荐优先使用;阿里云镜像对 bottles 支持更全,若遇到某软件提示“no bottle available”,可临时切到阿里源:https://mirrors.aliyun.com/homebrew-bottles
补上 API 和环境变量加速项
新版 Homebrew 会额外请求 formula.jws.json 这类 API 数据,默认走官网,也会拖慢 install/update:
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
- 添加环境变量:export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"
- 关闭烦人的提示(非必需但清爽):export HOMEBREW_NO_ENV_HINTS="1"
把这些 export 行加到你的 shell 配置文件末尾(~/.zshrc,macOS Catalina 及之后默认用 zsh):
echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"' >> ~/.zshrc
echo 'export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"' >> ~/.zshrc
echo 'export HOMEBREW_NO_ENV_HINTS="1"' >> ~/.zshrc
source ~/.zshrc
验证是否生效
换源后别急着装软件,先测试关键环节是否走国内:
- 运行 brew update,观察输出里是否出现 mirrors.ustc.edu.cn 或 mirrors.aliyun.com 的地址
- 执行 brew install wget --dry-run,看下载链接是否已变成镜像域名
- 如果仍有卡顿,用 brew doctor 检查是否有本地配置冲突或权限问题










