Homebrew Bottles 是预编译二进制包,国内用户需配置 HOMEBREW_BOTTLE_DOMAIN 环境变量指向中科大或阿里云镜像源,并写入对应 Shell 配置文件(如 ~/.zshrc);同时应同步替换 brew.git 和 homebrew-core.git 仓库源,才能实现索引更新与安装的全程加速。
homebrew bottles 是预编译好的二进制安装包,跳过本地编译,直接下载解压就能用。默认从国外服务器下载,国内用户常遇到几十kb/s、卡住甚至失败的问题。配置 bottle 镜像源是提速最关键的一步,必须配合环境变量生效。
确认你当前的 Shell 类型
Homebrew 通过环境变量 HOMEBREW_BOTTLE_DOMAIN 指定 Bottle 下载地址,这个变量要写入你的 Shell 配置文件并重新加载。先运行:
echo $SHELL如果输出是 /bin/zsh(M1/M2/M3 Mac 默认),就配 ~/.zshrc;如果是 /bin/bash,就配 ~/.bash_profile。
设置 Bottle 镜像地址(推荐中科大或阿里云)
中科大镜像同步快、稳定性高,阿里云 CDN 覆盖广、下载速度快。任选其一执行即可:
-
中科大源(推荐):
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zshrc && source ~/.zshrc -
阿里云源:
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.aliyun.com/homebrew/homebrew-bottles' >> ~/.zshrc && source ~/.zshrc
验证是否生效
执行以下命令检查变量是否已正确加载:
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
应输出你设置的镜像 URL。再试一次安装,比如:
brew install wget观察下载链接是否变成 mirrors.ustc.edu.cn 或 mirrors.aliyun.com 开头——说明 Bottle 已走国内镜像。
注意:Bottle 镜像需与仓库源配合使用
只配 Bottle 不换 brew.git 和 homebrew-core.git,更新索引仍会卡在 Updating Homebrew。建议同步完成完整配置:
- 替换核心仓库:
cd "$(brew --repo)" && git remote set-url origin https://mirrors.ustc.edu.cn/brew.git - 替换软件配方库:
cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core" && git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
这样三者统一,才能实现从索引更新到二进制下载的全程加速。

















