1.2 目录布局与核心术语

原文链接: https://docs.brew.sh/Manpage

刚接触 brew 时，最容易困惑的不是命令本身，而是一堆“酒馆”式的术语：Cellar、keg、rack、tap、bottle……其实这些名字背后是一套非常简单的文件布局。下面以 Apple Silicon 上的默认前缀 /opt/homebrew 为例说明。

一张术语表

理解 keg 与 Cellar

Homebrew 安装某个 formula 时，会把该版本完整安装到自己的 keg：

1

/opt/homebrew/Cellar/<软件名>/<版本号>/

接着它会把 bin、lib 等目录里的文件符号链接到 prefix：

1

/opt/homebrew/bin/<可执行文件>

这样你的 shell 只要把 /opt/homebrew/bin 放进 PATH，就能直接使用 brew 安装的命令。

opt prefix 则是一个永远指向“当前激活 keg”的符号链接。即使你升级了版本，/opt/homebrew/opt/foo 仍会指向最新激活的 keg，因此脚本和构建配置总是可以稳定引用它。

keg-only 的含义

某些 formula（例如 openssl）被标记为 keg-only，意思是它们只装入 Cellar，不会符号链接进 prefix。这样做的目的大多是避免与 macOS 系统自带的同名库冲突。运行 brew info <formula> 可以看到为什么它被标记为 keg-only，以及如何把它加入 PATH。详见 3.2 keg-only 与链接机制。

brew 本身放在哪里

可以用下面的命令查看各种关键路径：

1
2
3

brew --prefix        # 输出 prefix，例如 /opt/homebrew
brew --repository    # 输出 brew 仓库位置
brew --cache         # 输出下载缓存目录，例如 ~/Library/Caches/Homebrew

了解了这套布局后，很多“某个文件到底装到哪”的疑问都能自己解决：brew list <formula> 会列出 formula 安装的文件，brew info <formula> 则显示 keg-only、依赖等详细信息。