homebrew清理旧版本包有五种方法：1. brew cleanup删除旧版与30天以上缓存；2. brew cleanup -n预览待删内容；3. brew cleanup 定向清理指定软件旧版；4. brew cleanup --prune=all强制清除全部冗余缓存；5. 手动rm -rf $(brew --cache)清空缓存目录。
如果您在 macOS 上长期使用 Homebrew 安装软件，系统磁盘空间可能因旧版本 Formula 包持续堆积而显著减少。这些旧版本默认保留在 /opt/homebrew/Cellar（Apple Silicon）或 /usr/local/Cellar（Intel）目录中，占用数 GB 甚至数十 GB 空间。以下是多种安全、可选的清理旧版本包的方法：
一、执行基础清理移除所有旧版本与超期缓存
该命令默认删除所有已安装软件的旧版本（仅保留当前激活版本），同时清除超过30天的下载缓存归档（.tar.gz 文件），不触碰当前运行中的软件及其依赖关系，是最常用且零风险的操作。
1、打开终端应用（可通过 Spotlight 搜索 Terminal 或前往“应用程序 → 实用工具”）。
2、输入以下命令并回车执行：brew cleanup。
3、等待命令完成，终端将显示被删除的旧版本路径及释放的空间大小（例如“14.2GB reclaimed”）。
二、预览待删内容避免误删关键旧版
在执行实际清理前，可先查看哪些旧版本和缓存文件将被移除，特别适用于已使用 brew pin 锁定特定版本（如 python@3.11）但不确定是否仍被其他公式隐式依赖的场景。
1、在终端中运行：brew cleanup -n。
2、观察输出列表，重点关注 Cellar 中重复版本目录（如 /opt/homebrew/Cellar/node/20.12.1 与 /opt/homebrew/Cellar/node/20.10.0 并存时，后者通常为待删旧版）。
三、定向清理指定公式的旧版本
当仅需释放某一个大型软件（如 node、python、ffmpeg、rust）的历史版本空间，而不影响其他公式缓存或旧版保留策略时，该方法可精准控制范围，避免全局扫描带来的延迟。
1、确认目标软件名称，可通过 brew list | grep -i "python" 查看已安装的 Python 相关公式。
2、执行定向清理：brew cleanup python@3.12（以锁定版本为例）。
3、支持多公式同时清理：brew cleanup node python@3.11 ffmpeg。
四、强制清理全部冗余旧版与孤立缓存
当基础清理未释放预期空间（如存在大量已卸载软件残留的旧版 tarball、跨架构迁移后遗留的 Intel 缓存、或未被任何 formula 引用的构建中间产物），需启用深度清理模式，绕过30天时限并清除所有无主缓存项。
1、在终端中输入：brew cleanup --prune=all。
2、该命令会遍历 $(brew --cache) 目录（如 ~/Library/Caches/Homebrew），清除所有未被引用的归档文件。
3、执行后自动触发 brew autoremove（若已启用），移除不再被任何公式依赖的孤立包。
五、手动删除缓存目录释放底层空间
当 brew cleanup 命令因权限异常、路径损坏或 Homebrew 版本过旧而无法正常执行时，可直接清空用户级缓存目录。该操作不依赖 brew 命令逻辑，适用于紧急空间回收场景，且不会影响已安装软件功能。
1、确认缓存路径：brew --cache（通常返回 ~/Library/Caches/Homebrew）。
2、执行强制清除：rm -rf $(brew --cache)。
3、如需同步清理系统级缓存（仅限管理员权限）：sudo rm -rf /Library/Caches/Homebrew。
