必须切换国内镜像源才能完成Homebrew安装；推荐使用HomebrewCN一键脚本，自动适配芯片架构并内置清华、中科大、阿里云三镜像源，安装后需配置bottle镜像加速。
你在 macOS 上反复执行官方 Homebrew 安装命令却卡在 Cloning into 'homebrew-core' 或报错 curl: (7) Failed to connect to raw.githubusercontent.com，说明 GitHub 原始资源访问已不可靠，必须切换国内镜像源才能完成安装。
一键式交互安装（推荐新手，自动适配 M 系列/Intel 芯片）
该方法由 HomebrewCN 社区维护，全程中文提示，自动识别芯片架构（【M1/M2/M3 装到 /opt/homebrew，Intel 装到 /usr/local】），并内置清华、中科大、阿里云三镜像源可选，无需手动改配置文件。
打开终端（Spotlight 搜索「终端」→回车），粘贴执行以下整行命令（勿换行、勿删空格）：
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
脚本启动后，会列出镜像源选项（例如：1-中科大、2-清华、3-阿里云）。【清华源响应最快、稳定性最高，直接输入 2 回车】。
提示输入密码时，键入当前用户管理员密码（输入过程无任何字符显示，属正常现象，输完直接回车）。
若脚本询问“是否删除之前安装的 Brew”，建议输入 Y 回车——旧残留会导致路径冲突或权限异常，尤其曾手动改过 /opt/homebrew 权限的机器。
等待自动完成：检测 CLT → 创建目录 → 克隆 brew 主仓库（走清华镜像）→ 初始化 core 仓库 → 写入环境变量。末尾出现 Installation successful! 即完成。
安装后立即生效 brew 命令
即使安装成功，新开终端仍可能报 command not found: brew——因为 M 系列芯片的 brew 二进制路径 /opt/homebrew/bin 尚未加入 shell 搜索路径。
执行以下命令使配置立刻生效：
source ~/.zprofile
验证是否成功：
brew --version
若输出类似 Homebrew 4.3.5 的版本号，说明 brew 已可用。
补全 bottles 镜像加速（避免后续 install 卡住）
brew 本体装好了，但安装软件时仍可能卡在下载二进制包（bottle），因为默认 bottle 域名仍是 GitHub。必须单独配置 bottle 镜像源。
方法一（推荐阿里云，CDN 节点多、延迟低）：
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.aliyun.com/homebrew-bottles' >> ~/.zprofile && source ~/.zprofile
方法二（中科大备用）：
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zprofile && source ~/.zprofile
执行后，运行 brew update 测试：若看到大量 From https://mirrors.aliyun.com/... 日志，说明 bottle 源已切换成功。
