Mac怎么设置Homebrew国内镜像源加速-MAC-PHP中文网

根本原因是homebrew默认从github拉取数据，国内访问不稳定；切换清华镜像源可解决update卡顿、下载慢及超时错误，需同步修改brew/core/cask仓库地址并配置homebrew_bottle_domain环境变量。

mac怎么设置homebrew国内镜像源加速

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必须全部匹配对应镜像地址。

小易AI

小易AI是一款AI办公效率工具，易企秀推出的AI办公工具。

下载

设置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%用户提速失败的根源】。