返回博客

Mac 上的 Homebrew 缓存可以删除吗

~/Library/Caches/Homebrew 里装了什么,为什么删掉它不会卸载任何东西,brew cleanup 自己已经会清掉哪些内容,以及清理其余部分的命令。

已发表 2026年10月25日 作者 Vladimir Chemeris 阅读时间 约 1 分钟阅读
Homebrew缓存Developer Cleanup

删除 Homebrew 缓存是安全的。~/Library/Caches/Homebrew 存放的是下载文件和元数据,已安装的包在 Cellar 里,缓存碰不到它。在动手处理这个文件夹之前,先问问 brew cleanup 它会删掉什么。Homebrew 会自己修剪缓存,在我的 Mac 上,整个文件夹只有 527 MB,而已安装的 formula 占了 2.1 GB。

基本原则:每条清理命令都先加 -n 运行一遍。它会列出将要删除的内容以及能释放多少空间。

快速回答

  1. 用 brew --cache 找到这个文件夹。
  2. 运行 brew cleanup -n,看看常规清理会删除什么。
  3. 运行 brew cleanup --prune=all -n,看看清空整个缓存能释放多少。
  4. 去掉 -n,运行你选定的那条命令。
  5. 运行 brew autoremove -n,找出已经没有任何东西需要的依赖。
  6. Cellar 交给 brew uninstall 处理。

缓存里有什么

我在 2026 年 10 月 25 日量了自己 Mac 上的这个缓存,Homebrew 版本是 7.0.10:

~/Library/Caches/Homebrew 内存放内容在我的 Mac 上
downloadsbottle、源码压缩包和 cask 安装包484 MB
api来自 Homebrew JSON API 的 formula 和 cask 元数据30 MB
bootsnap让 brew 自身运行更快的加载缓存13 MB

已安装的 formula 在别处,位于 brew --prefix 下的 Cellar 里。在 Apple 芯片机型上,它是 /opt/homebrew/Cellar,在我的 Mac 上占 2.1 GB。Homebrew 的日志放在 ~/Library/Logs/Homebrew。

Homebrew 已经会自己清理什么

brew 的手册页描述了两条自动规则:

  • brew install、brew upgrade 和 brew reinstall 会针对它们涉及的包运行 brew cleanup,并且每 30 天对所有包运行一次。设置 HOMEBREW_NO_INSTALL_CLEANUP 可以关闭这一行为。
  • brew cleanup 会删除超过 120 天的下载。HOMEBREW_CLEANUP_MAX_AGE_DAYS 可以修改这个天数。

一次清理还会删除过时的下载、失效的锁文件以及已安装 formula 的旧版本。最后这一项释放的是 Cellar 里的空间,而更大的节省往往就在那里。

在我的 Mac 上,brew cleanup -n 没找到任何可删的东西,因为自动清理已经把常规工作做完了。brew cleanup --prune=all -n 则报告能释放约 507 MB。

删除缓存会改变什么

  • 已安装的包还在。 之后 brew list 显示的 formula 和 cask 和原来一样。
  • 重装要重新下载。 重装或升级某个包时,会从网络获取它的 bottle 或安装包。
  • cask 安装包没了。 cask 下载的 .dmg 和 .pkg 文件会随缓存一起消失。
  • brew 会重新创建这个文件夹。 下一次下载就会把它写回来。

命令,从温和到彻底

brew cleanup -n               # what a routine cleanup would remove
brew cleanup                  # remove it
brew cleanup --prune=all -n   # what removing every cached file would free
brew cleanup --prune=all      # remove it

brew cleanup -s,也就是 scrub 选项,还会删除最新版本的下载。不过你已安装的 formula 和 cask 的下载仍会保留;如果连这些也想清掉,手册页给出的办法是 rm -rf "$(brew --cache)"。在访达里把这个文件夹移入废纸篓效果相同,还给你留了退路。

brew autoremove -n 处理的是另一类残留:只作为依赖安装的 formula,而依赖它们的东西已经被你删掉了。它释放的是 Cellar 里的空间,而不是缓存里的。

缓存不是问题所在时

如果缓存只有几百 MB,你要找的空间在别处。用 du -sh "$(brew --prefix)/Cellar" 查一下 Cellar,卸掉不再使用的东西。然后去看那些通常让 Homebrew 相形见绌的开发者文件夹:Xcode 的 DerivedData、模拟器,以及 SwiftPM 这类包缓存。

总结

清空 Homebrew 缓存不会弄坏任何东西,而且这个文件夹很少会很大,因为 Homebrew 每 30 天就修剪一次。用 brew cleanup -n 看看还剩什么,想清空文件夹就用 --prune=all,没人需要的依赖交给 brew autoremove。整个过程中,已安装的包都原地不动。

关于作者

Vladimir Chemeris

StorageRadar 创始人

Vladimir Chemeris 开发 StorageRadar,一款注重隐私的 macOS 存储分析应用,强调先审查后清理、开发者存储和前后对比。

常见问题

可以删除 ~/Library/Caches/Homebrew 吗?

可以。这个缓存存放的是下载文件、API 元数据和 brew 自己的加载缓存。已安装的包位于 brew --prefix 下的 Cellar 里,不受影响。唯一的代价是重装或升级时要重新下载文件。

brew cleanup 会删除已安装的包吗?

不会。它删除的是过时的下载、失效的锁文件以及已安装 formula 的旧版本。你装的每样东西,当前版本都会留着。

Homebrew 多久自动清理一次缓存?

brew install、brew upgrade 和 brew reinstall 会针对它们涉及的包运行一次清理,并且每 30 天对所有包运行一次,除非设置了 HOMEBREW_NO_INSTALL_CLEANUP。清理默认删除超过 120 天的下载,这个天数由 HOMEBREW_CLEANUP_MAX_AGE_DAYS 设定。

如何清空整个 Homebrew 缓存?

先运行 brew cleanup --prune=all -n,看看它会删除什么、能释放多少空间,然后去掉 -n 再运行一次。在我的 Mac 上,它报告能从 527 MB 的文件夹里释放约 507 MB。

Homebrew 缓存在 Mac 的什么位置?

运行 brew --cache。在 macOS 上它会输出 ~/Library/Caches/Homebrew。已安装的 formula 在 Cellar 里,Apple 芯片机型上是 /opt/homebrew/Cellar。

来源和参考文献

看清每个包缓存及其大小。

StorageRadar 的 Dev Cleanup 把 Homebrew、npm、pnpm、Yarn、pip 和 SwiftPM 的缓存与 Xcode 的文件夹并排显示大小,按风险给每一项打上标签,并在清理之前展示 Dry Run 的结果。