彻底卸载Homebrew需“自动卸载+手动补全”:先运行官方脚本/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)",再按芯片架构删主目录(M1/M2/M3用sudo rm -rf /opt/homebrew,Intel用sudo rm -rf /usr/local/Homebrew /usr/local/bin/brew),接着清理shell配置中的PATH、清空缓存日志及var目录。

要彻底移除 macOS 中的 Homebrew 环境,不能只靠官方卸载脚本——它只清理核心目录,大量残留(如环境变量、缓存、权限配置、Git 仓库)会留在系统里,导致重装失败或命令冲突。关键在于“自动卸载 + 手动补全清理”两步到位。
运行官方卸载脚本(基础清除)
这一步会删掉 Homebrew 主程序、Cellar、Caskroom 和大部分 bin 文件:
- 打开终端,粘贴并执行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"- 按提示输入管理员密码,确认
y - 完成后运行
which brew,若无输出,说明命令已失效,基础卸载成功
按芯片架构删除主安装目录
Homebrew 在不同芯片上默认路径不同,必须对应清理,否则重装时会报错或覆盖失败:
-
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 brew
清理 shell 配置中的 PATH 和初始化语句
即使 brew 命令没了,zsh 或 bash 还可能在启动时尝试加载不存在的路径,引发 warning 或卡顿:
- 编辑当前 shell 配置文件:
nano ~/.zshrc(macOS Catalina 及之后默认用 zsh) - 查找并删除整行类似内容:
export PATH="/opt/homebrew/bin:$PATH"或eval "$(/opt/homebrew/bin/brew shellenv)" - 保存后执行
source ~/.zshrc让修改立即生效 - 如果用的是旧版 bash,检查
~/.bash_profile或~/.bashrc
清空缓存、日志与临时数据
这些文件不占大空间,但常引发重装时的校验失败(如 Checksum mismatch)、Portable Ruby 安装中断等问题:
rm -rf ~/Library/Caches/Homebrewrm -rf ~/Library/Logs/Homebrew-
rm -rf /usr/local/var/homebrew(Intel)或rm -rf /opt/homebrew/var/homebrew(Apple Silicon) - 可选:检查
~/.homebrew-*或~/.brew*隐藏文件,一并删除
做完以上四步,Homebrew 就真正从系统中清空了。重装前建议先运行 xcode-select --install 确保命令行工具就绪,再用标准脚本安装即可。


















