Brew Maintain

Homebrew 日常维护助手

快速命令

完整维护流程（推荐每周执行）

brew update && brew outdated && brew upgrade && brew cleanup && brew doctor

单独命令说明

| 命令 | 作用 | |------|------| | brew update | 更新 Homebrew 自身和所有 formula 定义 | | brew outdated | 列出可升级的软件包 | | brew upgrade | 升级所有过期软件包 | | brew upgrade | 升级指定软件包 | | brew cleanup | 清理旧版本和缓存 | | brew doctor | 检查系统健康状态 |

维护步骤

1. 更新 Homebrew

brew update

获取最新的软件包定义。

2. 查看可升级软件包

brew outdated

列出所有有新版本的软件包。

3. 预览升级（可选）

brew upgrade --dry-run

查看将要执行的升级操作，不实际执行。

4. 执行升级

# 升级所有
brew upgrade

# 仅升级命令行工具
brew upgrade --formula

# 仅升级图形应用
brew upgrade --cask

# 强制升级自动更新的 cask
brew upgrade --greedy

5. 清理旧版本

# 查看可清理空间
brew cleanup -n

# 执行清理
brew cleanup

6. 健康检查

brew doctor

检查并修复潜在问题。

版本管理

锁定软件包版本

# 防止某个软件包被升级
brew pin 

# 解除锁定
brew unpin 

# 查看已锁定的软件包
brew list --pinned

查看软件包信息

# 查看软件包详情
brew info 

# 查看已安装的软件包
brew list

# 查看软件包依赖
brew deps 

# 查看依赖该软件包的其他包
brew uses --installed 

空间管理

# 查看缓存占用
du -sh $(brew --cache)

# 查看 Cellar 占用
du -sh $(brew --cellar)

# 清理所有缓存（更彻底）
rm -rf $(brew --cache)

故障排除

修复权限问题

sudo chown -R $(whoami) $(brew --prefix)/*

重置 Homebrew

brew update-reset

重新安装软件包

brew reinstall 

自动更新控制

禁用自动更新

已在 shell 配置中设置：

export HOMEBREW_NO_AUTO_UPDATE=1

临时启用自动更新

unset HOMEBREW_NO_AUTO_UPDATE && brew install 

执行原则

1. 先查看再操作：用 brew outdated 和 --dry-run 预览
2. 关键软件先锁定：对依赖特定版本的软件使用 brew pin
3. 定期清理：每次升级后运行 brew cleanup
4. 检查健康：遇到问题先运行 brew doctor

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: almax000
• Source: almax000/claude-skills
• License: MIT

Install and usage instructions live in the source repository linked above.