官方卸载脚本仅清除Homebrew主程序,需手动删除安装目录、shell配置、缓存日志等残留;Apple Silicon删/opt/homebrew,Intel删/usr/local/Homebrew;清理PATH、shellenv语句及~/Library/Caches/Logs/Homebrew等,最后验证brew --version报错且路径不存在即成功。
直接运行官方卸载脚本只能清除 homebrew 主程序,大量残留会留在系统里——比如环境变量、缓存目录、安装根路径、shell 初始化语句等。不清理干净,重装时容易报错、命令冲突,甚至 brew --version 都可能卡住或提示权限异常。
运行官方卸载脚本(基础清理)
这一步删掉核心文件:Cellar、Caskroom、/bin/brew、主程序逻辑等。
- 终端中执行:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
- 按提示输入 y 确认,再输管理员密码(输入时不显示字符)
- 完成后运行 which brew,若无输出,说明命令已失效,基础卸载成功
手动删除主安装目录(按芯片区分)
官方脚本不删顶层目录,必须手动补上,否则重装会路径冲突或报错。
- Apple Silicon(M1/M2/M3):执行 sudo rm -rf /opt/homebrew
- Intel Mac:执行 sudo rm -rf /usr/local/Homebrew /usr/local/bin/brew
- 检查是否清空:ls -la /opt | grep -i brew 或 ls -la /usr/local | grep -i homebrew,应无结果
清理 shell 配置中的 PATH 和初始化语句
即使 brew 命令没了,zsh 启动时仍可能加载已不存在的路径,导致 warning 或终端启动变慢。
- 编辑配置文件:nano ~/.zshrc(macOS Catalina 及之后默认)
- 查找并整行删除类似内容:
export PATH="/opt/homebrew/bin:$PATH"
eval "$(/opt/homebrew/bin/brew shellenv)"
$(brew --prefix)/bin - 保存后执行 source ~/.zshrc 立即生效
- 如用 bash,检查 ~/.bash_profile 或 ~/.bashrc
清空缓存、日志与数据目录
这些目录独立存在,脚本完全不碰,但常引发重装失败(如校验错误、Portable Ruby 中断)。
- 用户级缓存:rm -rf ~/Library/Caches/Homebrew
- 用户级日志:rm -rf ~/Library/Logs/Homebrew
- 数据目录:
Apple Silicon → rm -rf /opt/homebrew/var/homebrew
Intel → rm -rf /usr/local/var/homebrew - 顺手检查:ls -la ~ | grep -i "homebrew\|brew",删掉 ~/.homebrew-* 等隐藏文件
验证是否干净:重启终端,运行 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。


















