Homebrew安装失败必卡在三环节：下载脚本（curl:7错）、克隆仓库（fatal EOF/RPC failed）、拉取bottle（ghcr.io超时）；需依报错定位环节、清理残留、验证Xcode CLI及git/curl，再分步测试连通性。
homebrew 连接失败不是随机问题，它基本卡在三个固定环节：下载安装脚本、克隆主仓库、拉取二进制包（bottle）。排查的关键是看报错文字直接锁定哪一步断了，再针对性验证网络和环境。
看报错文字，快速定位故障环节
终端红字不是乱码，而是明确的线索：
- curl: (7) Failed to connect to raw.githubusercontent.com → 第一步失败，脚本根本没下下来，说明系统连 GitHub 原始源都通不了
- Cloning into '/opt/homebrew' fatal: early EOF 或 RPC failed; curl 56 → 第二步中断，脚本已运行，但 git clone 没完成，大概率是网络抖动或代理干扰
- Downloading from https://ghcr.io/... curl: (92) HTTP/2 stream 0 was not closed cleanly → 第三步失败，Homebrew 已装好，但首次 brew install 时拿不到预编译包，说明 bottle 源不通
分步验证连通性，不靠猜
别重试，先手动测关键地址是否可达：
- 测试原始脚本地址：curl -I https://raw.githubusercontent.com（应返回 200 或 301）
- 测试 GitHub 主仓库：git ls-remote https://github.com/Homebrew/brew HEAD（能返回 commit hash 才算通）
- 测试 bottle 镜像源：curl -I https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles（清华源常用，返回 200 即可）
- 顺便检查系统时间：date，误差超过 3 分钟会导致 SSL 握手失败
清理残留 + 检查基础依赖
反复安装失败后常留半残目录，会干扰后续流程：
- Apple Silicon（M1/M2/M3/M4）检查：ls /opt/homebrew，若存在但缺 bin/ 或 Library/，执行 sudo rm -rf /opt/homebrew
- Intel Mac 检查：ls /usr/local/Homebrew，同理清理不完整目录
- 确认 Xcode 命令行工具已装：xcode-select --install（弹窗就点 Install）
- 确认 git 和 curl 可用：which git 和 which curl 必须返回路径
国内用户优先走镜像安装+自动配置
官方脚本在国内大概率失败，直接换国内集成方案更省事：
- 运行镜像安装命令：/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
- 脚本会自动选清华、中科大或阿里云源，安装完立刻生效，不用手动切 remote
- 装完立即验证：brew -v 和 brew doctor
