Homebrew安装失败后需清理残留：先用brew --prefix确认路径，再用ls检查空目录或不完整.git；可选brew cleanup -s保守清理，或按序删除homebrew-core、homebrew-cask及.git；彻底清除则需删前缀目录、shell配置并刷新环境。
Mac上Homebrew安装失败后，终端里只显示“Error: Failed to download”或“curl: (7) Failed to connect”，但实际已在/usr/local或/opt/homebrew下写入了不完整的目录、空文件夹、半拉子git仓库，这些残缺文件会干扰后续重装，导致brew doctor反复报错、brew install拒绝执行。
确认残留是否真实存在
先运行brew --prefix查清Homebrew当前预期安装路径——Intel Mac默认是/usr/local，Apple Silicon默认是/opt/homebrew。如果命令直接报错或输出为空，说明连基础路径都没建好，那大概率就是安装中断后留下的“空壳目录”。
接着执行ls -la /usr/local | grep -E "(homebrew|brew)"（Intel）或ls -la /opt/homebrew | grep -E "(bin|Cellar|repo)"（Apple Silicon），重点看是否存在homebrew-core空文件夹、Cellar但里面没内容、.git目录不完整（缺少objects或refs子目录）等情况。
安全清理未完成的临时文件
方法一：用brew自带清理命令收尾
运行brew cleanup -s，它会扫描Cellar和Cache，删掉所有未被任何formula引用的旧版本包和下载中断的缓存包。这一步不会动到/usr/local/bin/brew或homebrew-core仓库本身，属于保守清理。
方法二：手动删除半成品仓库（仅当brew --prefix能正常返回且brew doctor明确提示“Invalid git repo”时使用）
进入Homebrew根目录：cd $(brew --prefix) → 执行rm -rf homebrew-core homebrew-cask → 再运行rm -f .git。这三步必须按顺序来，【先删子模块再删主.git，否则brew会误判为损坏仓库而拒绝重建】。
方法三：彻底清除安装痕迹（适用于多次安装失败、brew --prefix已失效或返回错误路径）
- 第一步：停掉所有brew相关进程，执行
pkill -f "brew"； - 第二步：删掉整个Homebrew前缀目录，Intel Mac执行
sudo rm -rf /usr/local/Homebrew /usr/local/bin/brew /usr/local/share/zsh/site-functions/_brew； - 第三步：清理shell配置中可能残留的brew路径，检查
~/.zshrc或~/.bash_profile，删掉含export PATH="/usr/local/bin:$PATH"或eval "$(/usr/local/bin/brew shellenv)"的行； - 第四步：刷新环境
source ~/.zshrc，再运行which brew确认无输出。
验证清理结果
执行brew --version，若返回“command not found: brew”，说明清理完成；若仍报错如“fatal: not a git repository”，说明.git残留未清干净，需回到方法二补删$(brew --prefix)/.git。
