Homebrew
Homebrew 缓存目录：安装很快，历史缓存更快变大
Homebrew 会保留下载包和元数据缓存，版本升级后仍可能长期存在，是非常典型的“看不见但可安全处理”的空间来源。
更新于:
阅读时长: 5 分钟
为什么会悄悄变大
每次 brew install 或 upgrade 都可能留下 bottle 包和 API 元数据。开发者长期安装/测试不同 formula 后，这些历史下载会逐步累计到几十 GB。
Free Mac Space 如何定位
Free Mac Space 会扫描 /opt/homebrew/Caches、/usr/local/Homebrew/Caches 与 ~/Library/Caches/Homebrew，并对 downloads、api 这类子目录做更细分扫描，快速定位真正的大头。
Free Mac Space 如何帮助清理
清理仅作用于缓存目录，且有严格路径校验。你可以在应用内清理过期下载/API 缓存，动作默认移动到回收站，同时写入本地审计日志。
安全边界
像 Cellar、Caskroom 这类实际安装目录在安全模型中属于“不要直接删”的路径，避免因为误删导致包管理环境损坏。
Free Mac Space 扫描路径
- /opt/homebrew/Caches
- /usr/local/Homebrew/Caches
- ~/Library/Caches/Homebrew
建议的月度检查步骤
- 缓存暴涨时先看 downloads 与 api 子目录。
- 不要把清理目标扩展到真实安装目录。
- 通过清理历史记录保留可追溯操作链路。
操作步骤（HowTo）
1. 识别 Homebrew 的增长来源
每次 brew install 或 upgrade 都可能留下 bottle 包和 API 元数据。开发者长期安装/测试不同 formula 后，这些历史下载会逐步累计到几十 GB。
2. 确认扫描覆盖路径
Free Mac Space 会扫描 /opt/homebrew/Caches、/usr/local/Homebrew/Caches 与 ~/Library/Caches/Homebrew，并对 downloads、api 这类子目录做更细分扫描，快速定位真正的大头。 重点路径：/opt/homebrew/Caches、/usr/local/Homebrew/Caches、~/Library/Caches/Homebrew。
3. 先看安全边界再执行动作
像 Cellar、Caskroom 这类实际安装目录在安全模型中属于“不要直接删”的路径，避免因为误删导致包管理环境损坏。
4. 按先审查后清理流程执行
清理仅作用于缓存目录，且有严格路径校验。你可以在应用内清理过期下载/API 缓存，动作默认移动到回收站，同时写入本地审计日志。
5. 复核动作 1
缓存暴涨时先看 downloads 与 api 子目录。
6. 复核动作 2
不要把清理目标扩展到真实安装目录。
7. 复核动作 3
通过清理历史记录保留可追溯操作链路。
常见问题
Homebrew 这类占用通常来自哪里？
主要来源包括：Bottle 下载包、源码压缩包、API 元数据缓存。每次 brew install 或 upgrade 都可能留下 bottle 包和 API 元数据。开发者长期安装/测试不同 formula 后，这些历史下载会逐步累计到几十 GB。
这篇文章建议重点查看哪些路径？
建议优先检查这些路径：/opt/homebrew/Caches、/usr/local/Homebrew/Caches、~/Library/Caches/Homebrew。Free Mac Space 会扫描 /opt/homebrew/Caches、/usr/local/Homebrew/Caches 与 ~/Library/Caches/Homebrew，并对 downloads、api 这类子目录做更细分扫描，快速定位真正的大头。
如何在不增加误删风险的前提下处理？
清理仅作用于缓存目录，且有严格路径校验。你可以在应用内清理过期下载/API 缓存，动作默认移动到回收站，同时写入本地审计日志。 像 Cellar、Caskroom 这类实际安装目录在安全模型中属于“不要直接删”的路径，避免因为误删导致包管理环境损坏。
月度复查时应该怎么执行？
缓存暴涨时先看 downloads 与 api 子目录。；不要把清理目标扩展到真实安装目录。；通过清理历史记录保留可追溯操作链路。