1. Homebrew为什么需要国内镜像源如果你经常在Mac上开发肯定对Homebrew不陌生。作为macOS上最受欢迎的包管理工具它让安装和管理开发环境变得无比简单。但很多国内开发者都遇到过这样的问题brew update卡住不动或者安装一个软件包要等上半小时。这背后的原因很简单——Homebrew默认使用的是GitHub的仓库而国内访问这些国外服务器经常会遇到网络不稳定、速度慢的情况。我自己刚用Homebrew时就深受其害。记得有一次更新Python环境brew install python这条命令硬是卡了40分钟最后还报错退出。后来才发现原来只需要切换到国内镜像源同样操作10秒就能完成。国内常用的镜像源有清华、中科大、阿里云等它们会定时同步Homebrew的官方仓库让你享受到飞一般的下载速度。2. 快速配置清华镜像源2.1 基础环境准备在开始配置前建议先检查你的Homebrew是否正常工作。打开终端输入brew --version如果看到类似Homebrew 4.0.0这样的版本号输出说明已经安装好了。如果是第一次使用可以用以下命令安装/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)注意如果连这个安装命令都执行不了可以先手动下载安装脚本或者使用国内镜像的安装URL。2.2 配置核心镜像源清华大学的镜像源是国内最稳定的选择之一。配置方法很简单只需要在终端执行以下命令export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git brew update这三行命令分别做了将brew主仓库切换到清华镜像将核心软件包仓库也切换到清华镜像立即执行更新操作2.3 配置其他仓库镜像除了核心仓库Homebrew还有其他几个常用仓库也需要配置for tap in core cask{,-fonts,-drivers,-versions} command-not-found; do brew tap --custom-remote --force-auto-update homebrew/${tap} https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-${tap}.git done brew update这段脚本会一次性配置所有官方仓库的镜像源包括homebrew-core核心软件包homebrew-caskMac应用homebrew-cask-fonts字体homebrew-cask-drivers驱动程序homebrew-cask-versions软件旧版本homebrew-command-not-found命令未找到提示3. 永久生效配置3.1 写入Shell配置文件上面的配置只在当前终端会话有效关闭终端后就失效了。要让配置永久生效需要把环境变量写入你的shell配置文件中。如果你用的是zshmacOS Catalina及以后版本的默认shell执行test -r ~/.zprofile echo export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git ~/.zprofile test -r ~/.zprofile echo export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git ~/.zprofile如果你用的是bash则应该写入~/.bash_profiletest -r ~/.bash_profile echo export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git ~/.bash_profile test -r ~/.bash_profile echo export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git ~/.bash_profile3.2 验证配置是否生效配置完成后新开一个终端窗口执行echo $HOMEBREW_BREW_GIT_REMOTE如果输出是清华镜像的URL说明配置成功了。现在你可以尝试运行brew update应该能明显感觉到速度的提升。4. 其他国内镜像源选择4.1 中科大镜像源除了清华中科大的镜像源也是不错的选择。配置方法类似export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.ustc.edu.cn/brew.git export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.ustc.edu.cn/homebrew-core.git brew update4.2 阿里云镜像源阿里云也提供了Homebrew镜像服务export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.aliyun.com/homebrew/brew.git export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.aliyun.com/homebrew/homebrew-core.git brew update4.3 镜像源速度对比我实测过几个主流镜像源的速度供大家参考镜像源平均下载速度同步频率稳定性清华12MB/s每2小时★★★★★中科大10MB/s每3小时★★★★☆阿里云8MB/s每4小时★★★☆☆5. 常见问题解决5.1 更新时出现证书错误有时候切换镜像源后可能会遇到SSL证书错误这是因为某些镜像源的证书配置问题。可以临时关闭证书验证export HOMEBREW_NO_INSECURE_REDIRECT1 brew update但这不是长久之计建议联系镜像源维护者解决证书问题。5.2 某些软件包找不到镜像源同步可能会有延迟如果你需要的软件包在镜像源中找不到可以临时切换回官方源unset HOMEBREW_BREW_GIT_REMOTE unset HOMEBREW_CORE_GIT_REMOTE brew update下载完需要的软件包后再切换回镜像源。5.3 更新后出现冲突有时候不同镜像源之间的同步状态不一致可能会导致依赖冲突。这时候可以尝试brew cleanup brew doctor这两条命令会清理旧版本软件包并检查环境问题能解决大部分冲突问题。6. 进阶技巧6.1 使用代理加速如果你有更快的网络访问方式可以针对Homebrew设置代理export ALL_PROXYsocks5://127.0.0.1:1080 brew update6.2 批量更新所有软件包配置好镜像源后更新所有已安装的软件包就很简单了brew update brew upgrade brew cleanup这条命令会依次执行更新Homebrew自身升级所有可更新的软件包清理旧版本6.3 查看当前使用的源想知道当前Homebrew使用的是哪个源可以检查git远程地址cd $(brew --repository) git remote -v cd $(brew --repository)/Library/Taps/homebrew/homebrew-core git remote -v
Homebrew高效升级与国内镜像源配置全攻略
发布时间：2026/6/26 21:36:43
1. Homebrew为什么需要国内镜像源如果你经常在Mac上开发肯定对Homebrew不陌生。作为macOS上最受欢迎的包管理工具它让安装和管理开发环境变得无比简单。但很多国内开发者都遇到过这样的问题brew update卡住不动或者安装一个软件包要等上半小时。这背后的原因很简单——Homebrew默认使用的是GitHub的仓库而国内访问这些国外服务器经常会遇到网络不稳定、速度慢的情况。我自己刚用Homebrew时就深受其害。记得有一次更新Python环境brew install python这条命令硬是卡了40分钟最后还报错退出。后来才发现原来只需要切换到国内镜像源同样操作10秒就能完成。国内常用的镜像源有清华、中科大、阿里云等它们会定时同步Homebrew的官方仓库让你享受到飞一般的下载速度。2. 快速配置清华镜像源2.1 基础环境准备在开始配置前建议先检查你的Homebrew是否正常工作。打开终端输入brew --version如果看到类似Homebrew 4.0.0这样的版本号输出说明已经安装好了。如果是第一次使用可以用以下命令安装/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)注意如果连这个安装命令都执行不了可以先手动下载安装脚本或者使用国内镜像的安装URL。2.2 配置核心镜像源清华大学的镜像源是国内最稳定的选择之一。配置方法很简单只需要在终端执行以下命令export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git brew update这三行命令分别做了将brew主仓库切换到清华镜像将核心软件包仓库也切换到清华镜像立即执行更新操作2.3 配置其他仓库镜像除了核心仓库Homebrew还有其他几个常用仓库也需要配置for tap in core cask{,-fonts,-drivers,-versions} command-not-found; do brew tap --custom-remote --force-auto-update homebrew/${tap} https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-${tap}.git done brew update这段脚本会一次性配置所有官方仓库的镜像源包括homebrew-core核心软件包homebrew-caskMac应用homebrew-cask-fonts字体homebrew-cask-drivers驱动程序homebrew-cask-versions软件旧版本homebrew-command-not-found命令未找到提示3. 永久生效配置3.1 写入Shell配置文件上面的配置只在当前终端会话有效关闭终端后就失效了。要让配置永久生效需要把环境变量写入你的shell配置文件中。如果你用的是zshmacOS Catalina及以后版本的默认shell执行test -r ~/.zprofile echo export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git ~/.zprofile test -r ~/.zprofile echo export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git ~/.zprofile如果你用的是bash则应该写入~/.bash_profiletest -r ~/.bash_profile echo export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git ~/.bash_profile test -r ~/.bash_profile echo export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git ~/.bash_profile3.2 验证配置是否生效配置完成后新开一个终端窗口执行echo $HOMEBREW_BREW_GIT_REMOTE如果输出是清华镜像的URL说明配置成功了。现在你可以尝试运行brew update应该能明显感觉到速度的提升。4. 其他国内镜像源选择4.1 中科大镜像源除了清华中科大的镜像源也是不错的选择。配置方法类似export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.ustc.edu.cn/brew.git export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.ustc.edu.cn/homebrew-core.git brew update4.2 阿里云镜像源阿里云也提供了Homebrew镜像服务export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.aliyun.com/homebrew/brew.git export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.aliyun.com/homebrew/homebrew-core.git brew update4.3 镜像源速度对比我实测过几个主流镜像源的速度供大家参考镜像源平均下载速度同步频率稳定性清华12MB/s每2小时★★★★★中科大10MB/s每3小时★★★★☆阿里云8MB/s每4小时★★★☆☆5. 常见问题解决5.1 更新时出现证书错误有时候切换镜像源后可能会遇到SSL证书错误这是因为某些镜像源的证书配置问题。可以临时关闭证书验证export HOMEBREW_NO_INSECURE_REDIRECT1 brew update但这不是长久之计建议联系镜像源维护者解决证书问题。5.2 某些软件包找不到镜像源同步可能会有延迟如果你需要的软件包在镜像源中找不到可以临时切换回官方源unset HOMEBREW_BREW_GIT_REMOTE unset HOMEBREW_CORE_GIT_REMOTE brew update下载完需要的软件包后再切换回镜像源。5.3 更新后出现冲突有时候不同镜像源之间的同步状态不一致可能会导致依赖冲突。这时候可以尝试brew cleanup brew doctor这两条命令会清理旧版本软件包并检查环境问题能解决大部分冲突问题。6. 进阶技巧6.1 使用代理加速如果你有更快的网络访问方式可以针对Homebrew设置代理export ALL_PROXYsocks5://127.0.0.1:1080 brew update6.2 批量更新所有软件包配置好镜像源后更新所有已安装的软件包就很简单了brew update brew upgrade brew cleanup这条命令会依次执行更新Homebrew自身升级所有可更新的软件包清理旧版本6.3 查看当前使用的源想知道当前Homebrew使用的是哪个源可以检查git远程地址cd $(brew --repository) git remote -v cd $(brew --repository)/Library/Taps/homebrew/homebrew-core git remote -v
