Mac配置中科大镜像源可显著提升brew update和install速度，需替换Homebrew四大远程地址并写入~/.zshrc永久生效，M系列芯片还需配置PATH。

mac 配置中科大镜像源能显著提升 brew update 和 brew install 的速度，解决超时、卡死、下载慢等问题。核心是替换 homebrew 的四个关键远程地址，并让这些配置在终端重启后依然生效。

一、安装前先设置环境变量（推荐一步到位）

打开终端，一次性执行以下命令（整段复制粘贴，回车运行）：

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! 即表示安装完成。

二、Apple Silicon（M1/M2/M3/M4）用户必须配置 PATH

安装完成后，M 系列芯片默认装在 /opt/homebrew，需手动加入 shell 环境：

• 执行：echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
• 再执行：source ~/.zshrc

Intel Mac 通常自动配置，可跳过此步，但建议仍运行 brew --version 确认是否识别。

三、永久生效：把镜像变量写入配置文件

上面的 export 命令只在当前终端有效，重启后会丢失。要长期使用中科大源，请追加到 shell 配置文件中：

• 对 zsh 用户（macOS Catalina 及之后默认）：echo 'export HOMEBREW_INSTALL_FROM_API=1' >> ~/.zshrc
• 逐行追加其余四行变量（注意每行开头不要空格）
• 最后执行：source ~/.zshrc

验证是否写入成功：运行 cat ~/.zshrc | grep HOMEBREW，应能看到全部五条变量。

四、验证与日常维护

执行以下命令确认配置已生效：

• brew --version —— 应显示版本号，无报错
• brew tap-info homebrew/core —— Remote 地址应为 https://mirrors.ustc.edu.cn/homebrew-core.git
• brew update —— 正常应在 10 秒内完成，而非几分钟

如后续想切换回官方源，只需删除 ~/.zshrc 中相关 export 行并重新 source 即可。