news 2026/4/18 6:58:17

macOS Homebrew 重装指南:完整步骤与命令

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
macOS Homebrew 重装指南:完整步骤与命令

执行摘要

通过国内Gitee源的卸载脚本完成了Homebrew卸载,但脚本未能完全删除/usr/local/目录下的相关文件,需要手动清理残留。接下来需要重新安装Homebrew并配置国内镜像以加速软件包下载。

📋 已完成的卸载步骤

1. 执行卸载脚本

/bin/zsh -c"$(curl-fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/HomebrewUninstall.sh)"
  • 选择选项2(Gitee源卸载脚本)
  • 脚本调用了官方卸载程序,但部分目录因权限问题未能删除

2. 卸载结果分析

已成功删除的目录:

  • /Users/wangzhenye/Library/Caches/Homebrew/
  • /Users/wangzhenye/Library/Logs/Homebrew/

因权限问题未删除的目录:

  • /usr/local/Caskroom/Permission denied
  • /usr/local/Cellar/Permission denied

残留的Homebrew相关目录:

  • /usr/local/Homebrew/
  • /usr/local/bin/
  • /usr/local/cli-plugins/
  • /usr/local/etc/
  • /usr/local/lib/
  • /usr/local/share/
  • /usr/local/var/

🔧 清理残留文件(手动操作)

1. 检查芯片类型(确认后续路径)

uname-m
  • 返回x86_64= Intel芯片
  • 返回arm64= Apple Silicon芯片(M1/M2/M3)

2. 手动删除残留目录

根据你的芯片类型选择相应命令:

对于Apple Silicon芯片(arm64):

# 使用sudo提升权限删除残留sudorm-rf /opt/homebrewsudorm-rf /usr/local/Homebrewsudorm-rf /usr/local/Caskroomsudorm-rf /usr/local/Cellarsudorm-rf /usr/local/var/homebrew# 清理其他残留sudorm-rf /usr/local/bin/brewsudorm-rf /usr/local/cli-plugins/brewsudorm-rf /usr/local/etc/bash_completion.d/brewsudorm-rf /usr/local/share/doc/homebrewsudorm-rf /usr/local/share/man/man1/brew.1

对于Intel芯片(x86_64):

# 主要清理/usr/local/下的残留sudorm-rf /usr/local/Homebrewsudorm-rf /usr/local/Caskroomsudorm-rf /usr/local/Cellarsudorm-rf /usr/local/var/homebrew# 清理brew可执行文件和相关文件sudorm-f /usr/local/bin/brewsudorm-rf /usr/local/cli-plugins/brewsudorm-rf /usr/local/etc/bash_completion.d/brew

3. 清理用户缓存(可选但建议)

# 删除用户目录下的缓存和配置rm-rf ~/.homebrewrm-rf ~/Library/Caches/Homebrewrm-rf ~/Library/Logs/Homebrew

🚀 重新安装Homebrew

1. 安装前准备

确保已安装Xcode命令行工具:

xcode-select --install

2. 使用国内镜像安装(推荐)

/bin/zsh -c"$(curl-fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

安装过程中会提示:

  • 选择镜像源:建议选择1(清华大学源)或2(中科大源)
  • 输入管理员密码:需要sudo权限

3. 验证安装

# 检查版本brew -v# 运行诊断brew doctor# 更新brew自身brew update

⚠️ 注意事项

1. 权限问题处理

如果遇到权限错误,可以:

# 检查目录所有权ls-la /usr/local/# 修复权限(谨慎使用)sudochown-R$(whoami)/usr/local/*# 仅当你知道自己在做什么时使用

2. 环境变量配置

安装后如果brew命令不可用,需要配置环境变量:

对于Zsh用户:

echo'eval "$(/opt/homebrew/bin/brew shellenv)"'>>~/.zshrcsource~/.zshrc

对于Bash用户:

echo'eval "$(/opt/homebrew/bin/brew shellenv)"'>>~/.bash_profilesource~/.bash_profile

3. 镜像源配置(如安装脚本未自动配置)

# 替换brew.git镜像cd"$(brew --repo)"gitremote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git# 替换homebrew-core.git镜像cd"$(brew --repo)/Library/Taps/homebrew/homebrew-core"gitremote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git# 更新生效brew update

📊 问题排查检查表

问题可能原因解决方案
brew: command not found环境变量未配置按上述"环境变量配置"步骤操作
权限拒绝错误残留文件所有权问题使用sudo或修复目录所有权
安装速度慢未使用国内镜像重新运行安装脚本选择国内源
某些命令不可用未安装Xcode命令行工具运行xcode-select --install

💡 最佳实践建议

  1. 定期清理:使用brew cleanup定期清理旧版本
  2. 备份列表:重装前使用brew leaves > brew_packages.txt备份已安装包列表
  3. 使用Bundle:考虑使用brew bundle管理软件包依赖
  4. 查看日志:如有问题查看~/Library/Logs/Homebrew/下的日志文件

通过以上步骤,你应该能完成Homebrew的彻底重装。如果在执行过程中遇到具体错误信息,可以进一步提供详细信息以便针对性解决。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/16 13:51:01

高校网络教学实践:Packet Tracer下载部署方案

高校网络教学如何“零成本”拥有专属实验室?Packet Tracer实战部署全解析 你有没有遇到过这样的尴尬: 讲完VLAN划分,学生一脸茫然;布置完静态路由实验,第二天收上来的作业全是“ping不通”。问原因?——“…

作者头像 李华
网站建设 2026/4/16 10:18:45

Chrome密码找回终极指南:三步快速找回所有遗忘的登录信息

Chrome密码找回终极指南:三步快速找回所有遗忘的登录信息 【免费下载链接】chromepass Get all passwords stored by Chrome on WINDOWS. 项目地址: https://gitcode.com/gh_mirrors/chr/chromepass 你是否曾经盯着登录界面,明明在Chrome中保存过…

作者头像 李华
网站建设 2026/4/8 16:46:39

AI微信机器人终极指南:轻松实现智能自动回复与群管理

AI微信机器人终极指南:轻松实现智能自动回复与群管理 【免费下载链接】wechat-bot 🤖一个基于 WeChaty 结合 DeepSeek / ChatGPT / Kimi / 讯飞等Ai服务实现的微信机器人 ,可以用来帮助你自动回复微信消息,或者管理微信群/好友&am…

作者头像 李华
网站建设 2026/4/1 8:07:44

如何快速安装浏览器脚本:新手完整使用指南

如何快速安装浏览器脚本:新手完整使用指南 【免费下载链接】GreasyFork-Scripts 该项目开源代码用于主流浏览器的油猴脚本,包含字体渲染脚本 Font Rendering.user.js, 优雅的搜索引擎跳转助手 Google & Baidu Switcher.user.js. 项目地址: https:/…

作者头像 李华
网站建设 2026/4/14 19:30:51

老旧设备的数字新生:LeetDown降级工具的技术诗篇

老旧设备的数字新生:LeetDown降级工具的技术诗篇 【免费下载链接】LeetDown a GUI macOS Downgrade Tool for A6 and A7 iDevices 项目地址: https://gitcode.com/gh_mirrors/le/LeetDown 在数字世界的角落里,每一台老旧的iOS设备都藏着一个渴望重…

作者头像 李华
网站建设 2026/4/13 22:57:41

Markdown嵌入交互式图表:展示PyTorch-CUDA-v2.6性能数据

PyTorch-CUDA-v2.6 容器镜像:构建高效深度学习开发环境 在现代 AI 开发中,一个常见的痛点是——“代码写完了,环境却配不起来”。研究人员熬夜调通模型,结果换台机器就因 CUDA 版本不兼容、cuDNN 缺失或 Python 依赖冲突而无法运…

作者头像 李华