彻底卸载Homebrew需四步:先运行官方卸载脚本清除主干结构;再按芯片架构删除/opt/homebrew或/usr/local/Homebrew顶层目录;接着整行删除zshrc中PATH和shellenv相关语句;最后清空缓存、日志及var下的数据目录。

Mac上彻底卸载Homebrew不能只运行一个脚本就完事——官方卸载命令只删核心文件,PATH残留、缓存目录、shell初始化语句、/usr/local/var里的数据库数据全都会留下来,重装时大概率报错或命令冲突。
运行官方卸载脚本(基础清除)
这一步会移除 brew 可执行文件、Cellar、Caskroom 和 bin/brew 等主干结构,但不会碰环境变量和缓存:
在终端中粘贴并执行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
按提示输入 y 确认,再输入管理员密码(终端不显示字符)。
执行完毕后立即运行 which brew,若无任何输出,说明命令层已失效。
按芯片架构删除主安装目录
官方脚本故意不删顶层目录,否则重装时可能跳过关键初始化,导致路径混乱或权限异常。
先确认芯片类型:运行 arch,输出 arm64 为 Apple Silicon(M1/M2/M3),输出 x86_64 为 Intel。
Apple Silicon 用户执行:
sudo rm -rf /opt/homebrew
Intel 用户执行:
sudo rm -rf /usr/local/Homebrew /usr/local/bin/brew
执行后用 ls /opt/homebrew 2>/dev/null || echo "已清空" 或 ls /usr/local/Homebrew 2>/dev/null || echo "已清空" 验证。
清理 shell 配置中的 PATH 与初始化语句
即使 brew 命令没了,zsh 启动时仍会尝试加载已不存在的路径,引发 warning 或终端卡顿数秒。
编辑当前配置文件:nano ~/.zshrc(macOS Catalina 及之后默认)
查找并整行删除以下任意内容:export PATH="/opt/homebrew/bin:$PATH"eval "$(/opt/homebrew/bin/brew shellenv)"export PATH="/usr/local/bin:$PATH"(如果曾为 brew 单独加过)
保存后执行 source ~/.zshrc 立即生效。
注意:不要只删 PATH 中的路径片段,必须整行删除,否则语法错误会导致终端启动失败。
清空缓存、日志与数据目录
这些目录完全独立于主程序,官方脚本从不触碰,但它们是重装失败的高频原因(比如 Checksum mismatch、Portable Ruby 安装中断)。
依次执行以下命令:rm -rf ~/Library/Caches/Homebrewrm -rf ~/Library/Logs/Homebrew
Apple Silicon:sudo rm -rf /opt/homebrew/var/homebrew
Intel:sudo rm -rf /usr/local/var/homebrew
可选检查:ls -la ~/.homebrew-* 2>/dev/null,如有输出则一并 rm -rf ~/.homebrew-*。
验证是否真正干净
重启终端窗口(不是仅关闭标签页),确保所有配置重载。
执行以下三步验证:
① brew --version → 应提示 command not found
② echo $PATH → 输出中不得含 /opt/homebrew/bin 或 /usr/local/bin(除非你主动保留其他工具)
③ ls /opt/homebrew 2>/dev/null || ls /usr/local/Homebrew 2>/dev/null → 应全部返回 No such file or directory

















