Homebrew 卸载需彻底清理残留文件和环境变量,并切换国内镜像源以避免重装失败或下载缓慢;先运行官方卸载脚本,再手动删除对应架构目录、shell 配置中的 PATH 行及缓存,重装后立即配置清华或中科大镜像源并执行 brew update。

Homebrew 卸载不干净或镜像源没切对,容易导致后续重装失败、命令报错或下载极慢。下面分两部分说明:如何彻底卸载 Homebrew(包括残留文件和环境变量),以及如何安全切换为国内镜像源(清华、中科大等)。
一、彻底卸载 Homebrew(含所有残留)
官方提供的卸载脚本只清理核心目录,但 Homebrew 会分散写入 ~/.zshrc、/opt/homebrew(Apple Silicon)、/usr/local(Intel)、缓存、权限设置等,必须手动补全。
- 运行官方卸载命令(自动处理大部分):
curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh | /bin/bash - 删除残留目录(根据芯片类型选其一):
Apple Silicon(M1/M2/M3):
rm -rf /opt/homebrew
Intel Mac:
rm -rf /usr/local/Homebrew /usr/local/bin/brew - 清理 shell 配置中的 Homebrew 路径(检查并删掉类似行):
nano ~/.zshrc(或~/.bash_profile)
找到包含export PATH="/opt/homebrew/bin:$PATH"或$(brew --prefix)/bin的行,整行删除,保存退出后执行 source ~/.zshrc - 清除 brew 缓存与临时文件:
rm -rf ~/Library/Caches/Homebrew
rm -rf ~/Library/Logs/Homebrew
二、重装 Homebrew 并切换国内镜像源
重装前建议先确认网络通畅,且已切换系统语言为英文(避免某些中文路径引发权限异常)。安装后立即换源,否则首次 brew update 会卡在 GitHub。
- 安装(Apple Silicon 推荐用默认路径):
curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | /bin/bash - 切换为清华镜像源(最稳定,同步及时):
cd "$(brew --repo)"
git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
cd "$(brew --repo homebrew-core)"
git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git - 如需切换为中科大源(备用选项):
把上面两条https://mirrors.tuna.tsinghua.edu.cn/...替换为:
https://mirrors.ustc.edu.cn/homebrew-brew.git 和
https://mirrors.ustc.edu.cn/homebrew-core.git - 刷新并验证:
brew update(首次较慢,成功后无报错即生效)
brew tap | head -3 可查看当前 tap 源是否已走镜像
三、额外提醒(避坑关键点)
- 不要用
sudo brew—— Homebrew 设计为免 root 运行,加 sudo 反而破坏权限结构 - 若提示
"Permission denied (publickey)",说明 git 仍走 GitHub 原始地址,需重新检查git remote -v输出是否已更新为镜像 URL - 重装后首次
brew install前务必先brew update,否则可能拉取旧 formula 导致编译失败 - 如果使用 Oh My Zsh 或其他 shell 框架,确保
~/.zshrc中没有重复的brewPATH 行,避免冲突










