彻底清理中断的homebrew安装需五步：先运行官方卸载脚本清除核心结构；再按芯片架构删除残留主目录（apple silicon用/opt/homebrew，intel用/usr/local/homebrew）；接着清空用户及系统缓存、日志与/tmp/homebrew*；然后编辑~/.zshrc等文件移除无效path引用；最后删除/etc/paths.d/brew等系统级注册文件。
如果您在 macOS 上执行 Homebrew 安装命令时中断或失败，系统中可能残留部分未完成的目录、缓存、临时文件及环境变量引用，导致后续重装报错、路径冲突或 brew 命令不可用。以下是清理中断安装残留的多种命令行方法：
一、运行官方卸载脚本（基础清除）
该脚本可安全移除已写入的核心结构（如 /usr/local/Homebrew 或 /opt/homebrew 的初始化部分），即使安装未完成，也能终止并清理大部分已生成的文件。
1、打开终端，粘贴并执行以下命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
2、按提示输入 y 确认，再输入当前用户管理员密码（终端不显示字符）
3、执行完成后运行 which brew，若无任何输出，说明 brew 可执行文件已被移除
二、强制删除残留主目录（按芯片架构区分）
中断安装可能已在磁盘上创建空或半成品目录，需手动清除，否则重装时会因路径存在而跳过关键初始化步骤或报错“directory not empty”。
1、判断芯片类型：运行 arch，若输出 arm64 则为 Apple Silicon（M1/M2/M3）；若输出 i386 或 x86_64 则为 Intel
2、Apple Silicon 用户执行：
sudo rm -rf /opt/homebrew
3、Intel 用户执行：
sudo rm -rf /usr/local/Homebrew /usr/local/bin/brew
4、验证是否清空：
ls -d /opt/homebrew 2>/dev/null || echo "已不存在"（Apple Silicon）
ls -d /usr/local/Homebrew 2>/dev/null || echo "已不存在"（Intel）
三、清除用户级与系统级缓存及日志
中断安装过程常在 ~/Library/Caches/Homebrew 和 /Library/Caches/Homebrew 中写入部分下载碎片或临时锁文件，这些文件会干扰新安装流程，尤其引发 “Permission denied” 或 “Failed to download bottle” 错误。
1、删除用户缓存：
rm -rf ~/Library/Caches/Homebrew
2、删除用户日志：
rm -rf ~/Library/Logs/Homebrew
3、删除系统级缓存（需管理员权限）：
sudo rm -rf /Library/Caches/Homebrew
4、清理临时下载痕迹：
rm -rf /tmp/homebrew*
四、清理 shell 配置中的无效 PATH 引用
安装脚本若已执行到配置阶段，可能向 ~/.zshrc 或 ~/.bash_profile 写入了指向不存在路径的 export PATH 行，导致终端启动时出现 “No such file or directory” 警告，甚至阻塞 shell 初始化。
1、编辑当前 shell 配置文件：
nano ~/.zshrc（macOS Catalina 及之后默认）或 nano ~/.bash_profile（旧系统）
2、查找并删除包含以下任一内容的整行：
export PATH="/opt/homebrew/bin:$PATH"
export PATH="/usr/local/bin:$PATH"
eval "$(/opt/homebrew/bin/brew shellenv)"
3、保存退出后立即生效：
source ~/.zshrc（或 source ~/.bash_profile）
五、检查并移除系统级路径注册文件
Homebrew 安装过程中可能向 /etc/paths.d/ 和 /etc/manpaths.d/ 写入 brew 相关配置文件，中断后这些空文件或损坏链接仍被系统读取，造成 PATH 污染或 man 手册加载失败。
1、检查是否存在 brew 注册文件：
ls -l /etc/paths.d/brew /etc/manpaths.d/brew 2>/dev/null
2、若输出显示文件存在，执行删除：
sudo rm -f /etc/paths.d/brew /etc/manpaths.d/brew
3、验证是否已清除：
grep -r brew /etc/paths.d/ /etc/manpaths.d/ 2>/dev/null 应无任何输出
