官方卸载脚本仅清除Homebrew核心文件,彻底卸载需自动执行脚本+手动删除安装目录、环境变量、缓存日志等;否则残留会导致重装失败或终端报错。直接运行官方卸载脚本,能清除 Homebrew 核心文件,但“一键”不等于“彻底”。真正干净卸载需自动 + 手动两步配合,否则残留的路径、缓存、环境变量会导致重装失败或终端报错。
运行官方卸载脚本(基础清理)
这一步会删除 /opt/homebrew(apple silicon)或 /usr/local/homebrew(intel)、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 或 bash 启动时仍可能加载已不存在的路径,引发 warning 或卡顿:
- 编辑配置文件:
nano ~/.zshrc(macOS Catalina 及之后默认)或nano ~/.bash_profile(旧系统) - 查找并整行删除类似内容:
export PATH="/opt/homebrew/bin:$PATH"eval "$(/opt/homebrew/bin/brew shellenv)"$(brew --prefix)/bin - 保存后运行
source ~/.zshrc(或对应文件)立即生效
清空缓存、日志与数据目录
这些目录独立于主程序存在,脚本完全不碰,必须手动清理:
- 用户级缓存:
rm -rf ~/Library/Caches/Homebrew - 用户级日志:
rm -rf ~/Library/Logs/Homebrew - 系统级缓存(如有):
sudo rm -rf /Library/Caches/Homebrew - 数据目录(如 MySQL/PostgreSQL 数据):
sudo rm -rf /usr/local/var(谨慎操作,确认无重要数据)
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。










