Homebrew国内镜像安装方法有五种：一、一键式脚本自动适配芯片并选镜像源；二、中科大直连安装适用于M1/M2/M3；三、手动下载改源离线安装；四、Git克隆自定义路径安装；五、安装后必须配置bottle镜像加速。
如果您在 macOS 上尝试安装 Homebrew，但官方脚本因网络原因反复失败、卡在克隆仓库或超时中断，则很可能是 raw.githubusercontent.com 域名无法稳定访问。以下是多种经实测验证的国内镜像源快速安装方法，覆盖不同芯片架构与网络环境：
一、一键式国内镜像安装（推荐新手）
该方法由社区维护，自动适配 Apple Silicon（M1/M2/M3）与 Intel 芯片，全程自动配置中科大或清华镜像源，无需手动修改路径或环境变量。
1、打开终端（Terminal），粘贴并执行以下命令：
2、/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
3、按回车后，脚本将自动检测系统架构，并列出可选镜像源（如 1-中科大、2-清华、3-阿里云）；输入对应数字并回车确认。
4、提示输入密码时，键入当前用户管理员密码（输入过程不显示字符，输完直接回车）。
5、等待安装完成，期间会自动处理 /opt/homebrew（Apple Silicon）或 /usr/local（Intel）路径适配。
二、极简直连镜像安装（适合 M1/M2/M3 用户）
跳过交互式选择，强制使用中科大镜像加速核心仓库拉取，避免 GitHub 全链路阻塞，适用于已装好 Command Line Tools 的纯净环境。
1、确保已安装 Xcode Command Line Tools：在终端中运行 xcode-select --install，按提示完成安装。
2、执行中科大直连安装命令：
3、/usr/bin/ruby -e "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/install)"
4、若安装过程中卡在 Cloning into '/usr/local/Homebrew/Library/Taps/homebrew/homebrew-core'，立即按 Control + C 中断。
5、随后依次执行以下三行命令完成手动补全：
6、cd "$(brew --repo)/Library/Taps/" && mkdir homebrew && cd homebrew
7、git clone git://mirrors.ustc.edu.cn/homebrew-core.git
三、手动下载+本地执行安装（断网/受限网络适用）
当 curl 无法联网或企业防火墙拦截远程脚本时，可先下载安装脚本到本地，修改源地址后再执行，全程离线可控。
1、在浏览器中打开链接：https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh，右键另存为到桌面，文件命名为 Homebrew.sh。
2、打开终端，进入下载目录：cd ~/Desktop
3、赋予执行权限：chmod +x Homebrew.sh
4、编辑脚本替换镜像地址：运行 nano Homebrew.sh，查找所有出现的 github.com 字符串，将其替换为 mirrors.ustc.edu.cn，保存退出（Ctrl + O → Enter → Ctrl + X）。
5、执行本地安装：/bin/zsh ./Homebrew.sh
四、Git 克隆方式安装（开发者向/自定义路径）
适用于需指定安装路径（如统一部署至 /opt/homebrew）、规避权限冲突或已有 brew 目录残留的场景，完全绕过 Ruby 安装流程。
1、创建目标目录（Apple Silicon 推荐）：sudo mkdir -p /opt/homebrew
2、设置目录属主：sudo chown -R $(whoami) /opt/homebrew
3、克隆 brew 主仓库：git clone https://mirrors.ustc.edu.cn/brew.git /opt/homebrew
4、初始化核心 Tap：git -C "/opt/homebrew/Library/Taps/homebrew/homebrew-core" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
5、添加 brew 到 PATH：编辑 ~/.zshrc，末尾追加一行：export PATH="/opt/homebrew/bin:$PATH"，然后运行 source ~/.zshrc
五、安装后必做配置（提速关键）
即使使用镜像安装成功，若未配置二进制包（bottle）镜像，后续 brew install 仍可能因下载缓慢失败。此步必须执行。
1、配置 bottle 域名镜像：echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zshrc
2、重载配置：source ~/.zshrc
3、验证镜像生效：运行 brew tap-info homebrew/core | grep mirror，输出中应包含 ustc.edu.cn 字样。
4、运行诊断命令确认状态：brew doctor
