根本原因是Homebrew默认从GitHub拉取数据，国内访问不稳定；切换清华镜像源可解决update卡顿、下载慢及超时错误，需同步修改brew/core/cask仓库地址并配置HOMEBREW_BOTTLE_DOMAIN环境变量。
Mac上执行brew update卡在Updating Homebrew不动、安装软件下载速度只有几十KB/s、频繁报Operation timed out或SSL_ERROR_SYSCALL错误，根本原因是Homebrew默认从GitHub拉取数据，而GitHub在国内网络环境下访问极不稳定。切换国内镜像源是解决这一问题的唯一有效手段，它能将Formula索引更新、Cask清单同步、Bottle二进制包下载全部指向国内服务器，把平均下载速度从50KB/s提升至5MB/s以上。
确认当前Homebrew安装状态
打开终端，先检查Homebrew是否已安装且可正常调用：
输入brew --version，若返回类似Homebrew 4.3.5的版本号，说明已安装；若提示command not found: brew，需先完成基础安装（本文不覆盖首次安装流程，仅处理已装用户的镜像配置）。
这一步必须做，否则后续所有配置都无意义——【未安装brew直接配置镜像变量会导致环境变量写入后完全无效】。
一次性替换三大核心仓库地址（推荐清华源）
清华TUNA镜像源更新及时、稳定性高，且对Apple Silicon和Intel Mac均提供完整支持。以下命令将同时修改brew本体、homebrew-core配方库、homebrew-cask应用库的Git远程地址：
复制并执行以下整段命令（注意：不要分行粘贴，必须一次性运行）：
git -C $(brew --repo) remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git → git -C $(brew --repo homebrew/core) remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git → git -C $(brew --repo homebrew/cask) remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git
执行完成后，立即验证是否生效：运行git -C $(brew --repo) config --get remote.origin.url，输出应为https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git；同理检查core和cask仓库，三者URL必须全部匹配对应镜像地址。
设置Bottle二进制包下载镜像（关键提速步骤）
只改Git仓库地址还不够——Bottle预编译包仍会从GitHub官方地址下载，这是安装大体积软件（如node、ffmpeg、rust）时最卡的地方。必须单独配置环境变量强制Bottle走镜像：
方法一（临时生效，适合测试）：
在终端中运行：export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles
方法二（永久生效，生产环境必选）：
根据你的Shell类型选择：
→ 若使用zsh（macOS Catalina及之后系统默认）：执行echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles' >> ~/.zshrc && source ~/.zshrc
→ 若使用bash（旧系统或手动切换）：执行echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles' >> ~/.bash_profile && source ~/.bash_profile
这一步漏掉，brew install时仍会从海外下载Bottle，速度无法真正提升——【Bottle域名未配置是90%用户提速失败的根源】。
强制刷新本地缓存并验证加速效果
第一步：清空旧缓存避免冲突
运行rm -rf $(brew --cache)，删除所有已缓存的Formula和Bottle元数据。
第二步：执行完整更新流程
依次运行：
① brew update（此时应快速完成，不再卡在“Updating Homebrew”）
② brew upgrade（观察是否开始从mirrors.tuna.tsinghua.edu.cn下载）
第三步：实测安装速度
运行brew install wget，终端输出中若出现https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/.../wget--...路径，且下载速度显示为MB/s级别，即表示配置成功。
