亲测有效,如何macOS上卸载并且重新安装homeBrew

1,683 阅读1分钟

以下是 macOS 上彻底卸载并重新安装 Homebrew 的完整指南(基于最新技术文档整理):

一、彻底卸载 Homebrew

方法1:官方卸载脚本(推荐)

# Intel 芯片/M1/M2 通用命令(2025年最新版)
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/HomebrewUninstall.sh)"

执行后会:

  1. 自动识别芯片架构(Intel/Apple Silicon)
  2. 删除 /usr/local(Intel)或 /opt/homebrew(Apple Silicon)下的所有文件
  3. 清理缓存目录 ~/Library/Caches/Homebrew

方法2:手动清理(适用于脚本失效时)

# Apple Silicon 芯片专用
sudo rm -rf /opt/homebrew
rm -rf ~/Library/Caches/Homebrew

# Intel 芯片专用
sudo rm -rf /usr/local/Cellar /usr/local/Homebrew
rm -rf /usr/local/var/homebrew

需额外检查残留文件:

ls -la /usr/local | grep -i brew  # Intel
ls -la /opt | grep -i brew        # Apple Silicon

二、重新安装 Homebrew

标准安装(国内镜像加速)

# 2025年推荐安装命令(自动适配芯片架构)
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

安装过程会:

  1. 自动选择清华/中科大镜像源
  2. 安装必要的命令行工具(如git)
  3. 配置环境变量

验证安装

brew -v  # 应显示类似 Homebrew 4.2.1
brew doctor  # 检查系统兼容性

三、常见问题解决方案

  1. 权限错误:在命令前加 sudo 并输入管理员密码
  2. 安装中断:删除 /tmp/homebrew* 临时文件后重试
  3. M1/M2芯片问题:确保已安装 Rosetta 2(终端执行 softwareupdate --install-rosetta

四、注意事项

  1. 卸载会删除所有通过brew安装的软件,需提前备份
  2. 推荐使用国内镜像源避免网络问题(如清华源)
  3. 2025年起新系统需先安装 Xcode 命令行工具:xcode-select --install

如需更彻底的清理,可使用专业工具如 PowerMyMac 扫描残留文件。