Homebrew Cask 国内加速需将 homebrew/cask 仓库远程地址换为中科大镜像源（https://mirrors.ustc.edu.cn/homebrew-cask.git），并同步配置 brew、core 和 HOMEBREW_BOTTLE_DOMAIN，确保图形应用安装全程走国内节点，速度可达几 MB/s。
mac 上配置 homebrew cask 的国内加速源，核心就是把它的默认仓库地址（指向 github）换成国内镜像站的对应地址。cask 本身不单独安装，而是 homebrew 的一部分，所以必须先确保 homebrew 已正确安装，并且已换源——尤其是 homebrew/cask 这个子仓库。
确认 Homebrew 已安装并可用
打开终端，运行：
-
brew --version—— 看是否输出版本号（如4.2.0） -
brew doctor—— 检查基础环境有无明显问题
如果未安装，请先执行 Xcode 命令行工具安装：xcode-select --install
再用推荐的一键脚本安装（自动配好所有源）：/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
单独为 Cask 换源（中科大 USTC 镜像）
即使已用脚本安装，也可以手动确认或重置 Cask 源。运行以下命令：
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git
这条命令的作用是：定位到 homebrew/cask 本地仓库目录，把它的远程地址改成中科大镜像源。中科大同步频率高（每5分钟），应用更新及时，目前最稳。
验证是否生效：
-
git -C "$(brew --repo homebrew/cask)" remote get-url origin—— 应返回https://mirrors.ustc.edu.cn/homebrew-cask.git -
brew search --cask chrome—— 能快速列出结果即说明 Cask 元数据访问正常
顺带检查其他关键源（避免只换 Cask 却卡在 core 或 bottles）
Cask 只管图形应用（如 VSCode、Chrome、Docker Desktop），但实际安装时仍依赖 core（配方）和 bottles（预编译包）。建议一并配置：
- 主程序源：
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 - bottles 下载加速（需设置环境变量）：
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zshrc && source ~/.zshrc
完成后运行 brew update，首次可能稍慢（同步元数据），之后所有 brew install --cask xxx 都会从国内节点拉取，下载速度可达几 MB/s。
常见问题提醒
如果换源后仍卡在 Updating Homebrew 或报 error: failed to push some refs：
- 先运行
brew update --force强制刷新 - 检查是否误用了
sudo brew—— Homebrew 不需要 root 权限，加 sudo 可能导致权限混乱 - Apple Silicon（M1/M2/M3/M4）用户请确认路径是
/opt/homebrew，Intel 用户是/usr/local；命令中$(brew --repo ...)会自动适配，无需手动改路径
