以下是 macOS 上彻底卸载并重新安装 Homebrew 的完整指南(基于最新技术文档整理):
一、彻底卸载 Homebrew
方法1:官方卸载脚本(推荐)
bash
# Intel 芯片/M1/M2 通用命令(2025年最新版)
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/HomebrewUninstall.sh)"
执行后会:
- 自动识别芯片架构(Intel/Apple Silicon)
- 删除
/usr/local
(Intel)或/opt/homebrew
(Apple Silicon)下的所有文件 - 清理缓存目录
~/Library/Caches/Homebrew
方法2:手动清理(适用于脚本失效时)
bash
# 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
需额外检查残留文件:
bash
ls -la /usr/local | grep -i brew # Intel
ls -la /opt | grep -i brew # Apple Silicon
二、重新安装 Homebrew
标准安装(国内镜像加速)
bash
# 2025年推荐安装命令(自动适配芯片架构)
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
安装过程会:
- 自动选择清华/中科大镜像源
- 安装必要的命令行工具(如git)
- 配置环境变量
验证安装
bash
brew -v # 应显示类似 Homebrew 4.2.1
brew doctor # 检查系统兼容性
三、常见问题解决方案
- 权限错误 :在命令前加
sudo
并输入管理员密码 - 安装中断 :删除
/tmp/homebrew*
临时文件后重试 - M1/M2芯片问题 :确保已安装 Rosetta 2(终端执行
softwareupdate --install-rosetta
)
四、注意事项
- 卸载会删除所有通过brew安装的软件,需提前备份
- 推荐使用国内镜像源避免网络问题(如清华源)
- 2025年起新系统需先安装 Xcode 命令行工具:
xcode-select --install
如需更彻底的清理,可使用专业工具如 PowerMyMac 扫描残留文件。