homebrew安装失败必卡在三环节：下载脚本（curl: (7)错）、克隆仓库（fatal eof/rpc failed）、拉取bottle（ghcr.io超时）；需依报错定位环节、清理残留目录、验证xcode cli和git/curl依赖，再分步测试连通性。
homebrew安装报错不是随机发生的，它基本都卡在三个固定环节：下载安装脚本、克隆主仓库、拉取核心公式库。诊断的关键不是重试，而是分段定位哪一步断了、为什么断。
看报错文字直接锁定故障环节
终端里那一堆红字其实有规律可循：
- 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 → 卡在第三步，首次 brew install 时下载二进制包失败，说明基础环境已装好，但后续资源源不通
检查残留目录避免“假失败”
很多人重复执行安装命令，结果报错越来越奇怪，是因为第一次失败后留下了不完整的文件夹。先清理再诊断：
macOS Automator Services
下载
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...
- Intel Mac 检查：/usr/local/Homebrew
- Apple Silicon（M1/M2/M3/M4）检查：/opt/homebrew
- 如果这些目录存在但内容明显不全（比如只有 .git 文件夹，没有 bin/ 或 Library/），就手动删掉：sudo rm -rf /opt/homebrew
验证环境是否具备前置条件
Homebrew 不是独立运行的，它依赖系统底层工具。两个最常被忽略的前提必须满足：
- 运行 xcode-select --install 确认 Command Line Tools 已安装；若弹窗提示未安装，点“Install”等它装完
- 运行 which git 和 which curl，确保这两个命令能正常返回路径；如果报 command not found，先装好 Xcode 命令行工具
用最小命令手动模拟安装流程
跳过一键脚本，自己走一遍关键步骤，更容易看清卡点：
- 测试脚本下载：curl -I https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh（看是否返回 200）
- 测试 Git 克隆（以清华镜像为例）：git clone https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git /tmp/brew-test
- 测试公式库拉取：git -C /tmp/brew-test clone https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
