彻底卸载Homebrew需“自动卸载+手动清理”两步：先运行官方脚本清除主程序，再按芯片架构删除主目录、PATH引用、缓存、日志及数据目录。
mac 上彻底卸载 homebrew，不能只靠一条命令。官方卸载脚本只清主干，大量残留（比如缓存、path 引用、数据目录、软链接）会留在系统里，导致重装失败、终端报错、命令找不到，甚至影响 python/node 等工具行为。关键在“自动卸载 + 手动补全清理”两步到位，且必须区分 apple silicon（m1/m2/m3）和 intel 芯片路径。
先运行官方卸载脚本（基础清除）
这一步能安全移除 brew 主程序、Cellar、Caskroom 和大部分 bin 文件：
- 打开终端，粘贴执行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)" - 按提示输入 y 确认，再输管理员密码（终端不显示字符）
- 完成后运行 which brew，若无任何输出，说明 brew 命令已失效，基础卸载成功
手动删除主安装目录（按芯片架构）
官方脚本不删顶层目录，中断安装或旧版残留常卡在这里，必须手动清除，否则重装会跳过初始化或报错：
- Apple Silicon（M1/M2/M3）：执行 sudo rm -rf /opt/homebrew
- Intel Mac：执行 sudo rm -rf /usr/local/Homebrew /usr/local/bin/brew
- 验证是否清空：
Apple Silicon 运行 ls -d /opt/homebrew 2>/dev/null || echo "已不存在"
Intel 运行 ls -d /usr/local/Homebrew 2>/dev/null || echo "已不存在"
清理 shell 配置中的 PATH 和初始化语句
即使 brew 命令没了，zsh 或 bash 启动时仍可能加载已失效路径，引发 warning、卡顿甚至报错：
- 编辑配置文件：nano ~/.zshrc（macOS Catalina 及之后默认）或 nano ~/.bash_profile（旧系统）
- 查找并整行删除以下任一类内容：
export PATH="/opt/homebrew/bin:$PATH"
export PATH="/usr/local/bin:$PATH"
eval "$(/opt/homebrew/bin/brew shellenv)" - 保存后立即生效：source ~/.zshrc（或对应文件）
清空缓存、日志与数据目录
这些目录完全独立于主程序，脚本从不触碰，但占空间、易引发冲突，尤其重装前必须处理：
- 用户级缓存：rm -rf ~/Library/Caches/Homebrew
- 用户级日志：rm -rf ~/Library/Logs/Homebrew
- 系统级缓存（如有）：sudo rm -rf /Library/Caches/Homebrew
- Homebrew 数据目录（如 MySQL/PostgreSQL 的数据库文件）：sudo rm -rf /usr/local/var（操作前请确认无重要数据）
- 额外清理（可选）：
rm -rf /usr/local/opt/*（清空软链接）
find /usr/local/Cellar -mindepth 1 -maxdepth 1 -type d -empty -delete（删空的 Formula 目录）
验证是否干净：重启终端，执行 brew --version 应提示 command not found；echo $PATH 不含 /opt/homebrew/bin 或冗余的 /usr/local/bin；ls /opt/homebrew 或 ls /usr/local/Homebrew 应提示 No such file or directory。
