删除 Homebrew 缓存是安全的。~/Library/Caches/Homebrew 存放的是下载文件和元数据,已安装的包在 Cellar 里,缓存碰不到它。在动手处理这个文件夹之前,先问问 brew cleanup 它会删掉什么。Homebrew 会自己修剪缓存,在我的 Mac 上,整个文件夹只有 527 MB,而已安装的 formula 占了 2.1 GB。
基本原则:每条清理命令都先加 -n 运行一遍。它会列出将要删除的内容以及能释放多少空间。
快速回答
- 用
brew --cache找到这个文件夹。 - 运行
brew cleanup -n,看看常规清理会删除什么。 - 运行
brew cleanup --prune=all -n,看看清空整个缓存能释放多少。 - 去掉
-n,运行你选定的那条命令。 - 运行
brew autoremove -n,找出已经没有任何东西需要的依赖。 - Cellar 交给
brew uninstall处理。
缓存里有什么
我在 2026 年 10 月 25 日量了自己 Mac 上的这个缓存,Homebrew 版本是 7.0.10:
~/Library/Caches/Homebrew 内 | 存放内容 | 在我的 Mac 上 |
|---|---|---|
downloads | bottle、源码压缩包和 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。整个过程中,已安装的包都原地不动。
常见问题
可以删除 ~/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。