Mac 安装 Homebrew 慢?中科大镜像源加速配置教程
一、为什么你需要换源?
Homebrew 默认从 GitHub 拉取数据,在国内访问经常遇到以下问题:
- 下载速度只有几 KB/s
Operation timed out超时报错404 Not Found镜像失效- 一个软件装半小时,效率低下
解决方案:使用国内高校镜像源,中科大(USTC)是国内最稳定、更新最及时的镜像之一。
本文介绍如何在 Mac 上通过中科大镜像源快速安装 Homebrew 并配置永久加速。针对国内网络访问 GitHub 速度慢、超时等问题,提供环境变量设置、Git 仓库地址更换及 PATH 配置步骤。包含 Apple Silicon 与 Intel 芯片的不同处理方式,以及常用命令速查和常见问题解决方案,帮助开发者实现秒装软件。
Homebrew 默认从 GitHub 拉取数据,在国内访问经常遇到以下问题:
Operation timed out 超时报错404 Not Found 镜像失效解决方案:使用国内高校镜像源,中科大(USTC)是国内最稳定、更新最及时的镜像之一。
打开终端,一次性复制执行:
export HOMEBREW_INSTALL_FROM_API=1
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"
/bin/bash -c "$(curl -fsSL https://mirrors.ustc.edu.cn/misc/brew-install.sh)"
等待安装完成,看到 ==> Installation successful! 即表示成功。
M1/M2/M3 芯片用户执行:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc
Intel Mac 通常会自动配置好,可跳过此步。
brew --version
输出类似 Homebrew 4.x.x 即表示成功!
上面 Step 1 的变量重启后会失效,以下步骤永久生效:
echo 'export HOMEBREW_INSTALL_FROM_API=1' >> ~/.zshrc
echo 'export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"' >> ~/.zshrc
echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"' >> ~/.zshrc
echo 'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"' >> ~/.zshrc
echo 'export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"' >> ~/.zshrc
# 更换 brew 本身仓库
git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git
# 更换核心软件库
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
# 更换 GUI 软件库
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git
# 更新索引
brew update
brew config | grep -E "(HOMEBREW_BREW_GIT_REMOTE|HOMEBREW_CORE_GIT_REMOTE|HOMEBREW_BOTTLE_DOMAIN)"
看到中科大地址即表示配置成功。
| 命令 | 作用 |
|---|---|
brew install 软件名 | 安装软件(如 brew install wget) |
brew uninstall 软件名 | 卸载软件 |
brew search 关键词 | 搜索软件包 |
brew list | 查看已安装软件 |
brew update | 更新软件列表 |
brew upgrade | 升级所有软件 |
brew doctor | 诊断问题 |
brew cleanup | 清理旧版本缓存 |
安装示例:
# 一口气安装开发必备工具
brew install git node python wget tree htop
Q1:安装时提示 curl: (22) The requested URL returned error: 404
A:说明该镜像的 install.sh 脚本路径已变更,建议换用本文提供的中科大或阿里云方案。
Q2:brew 命令找不到?
A:Apple Silicon Mac 需要手动添加 PATH,执行:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc
Q3:如何恢复官方源? A:
# 删除环境变量
sed -i '/HOMEBREW/d' ~/.zshrc
# 恢复官方仓库
git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://github.com/Homebrew/homebrew-core.git
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://github.com/Homebrew/homebrew-cask.git
source ~/.zshrc && brew update

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online
将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online