本文介绍如何在 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