Homebrew 官方核心仓库审核严格，多数 Go 工具因不稳定、不流行或构建方式不符而无法入库，故开发者需自建 Tap：即 GitHub 上名为 homebrew-xxx 的公开仓库，仅托管 Ruby 编写的 Formula 文件，描述从指定 Git Tag 拉取源码、用 go build 构建、安装到 bin 的过程；用户通过 brew tap username/repo && brew install username/repo/tool 使用。
为什么 brew tap 不是发布 Go 工具的默认路径
因为 Homebrew 官方核心仓库（homebrew-core）对新工具审核极严：要求稳定版本、有明确维护者、足够流行、不能纯靠 go install 一键构建。多数小众或刚起步的 Go CLI 工具根本过不了审，所以开发者转向自建 Tap——本质是 GitHub 仓库 + Brew DSL 描述文件，由你全权维护。
关键点在于：Tap 本身不托管二进制，只托管 Formula 文件；Brew 用它来决定「从哪下载源码、用什么命令构建、安装到哪」。
- 你的 Go 工具必须有可访问的 Git 仓库（GitHub/GitLab 均可），且带语义化 Tag（如
v1.2.0） - 推荐使用
go build构建（非go install），确保可复现、无本地 GOPATH 依赖 - 不要指望 Tap 能自动同步新 Tag——每次发版都得手动更新 Formula 文件
怎么写一个最小可用的 Formula 文件
它就是一个 Ruby 脚本，描述如何拉代码、编译、安装。Go 工具最简结构只需三块：源码地址、版本号、构建逻辑。别写复杂逻辑，Brew 不执行任意 Ruby，只认白名单方法。
示例（假设工具叫 mycli，仓库在 github.com/you/mycli）：
立即学习“go语言免费学习笔记（深入）”；
class Mycli < Formula
desc "My awesome CLI tool"
homepage "https://github.com/you/mycli"
url "https://github.com/you/mycli/archive/refs/tags/v1.2.0.tar.gz"
sha256 "a1b2c3... (用 shasum -a 256 下载的 tar.gz 计算)"
depends_on "go" => :build
def install
system "go", "build", "-o", bin/"mycli", "./cmd/mycli"
end
end
-
url必须指向 GitHub 自动生成的archive/refs/tags/...链接，不是 raw 或主干分支 -
sha256必须和url对应压缩包完全一致，否则 Brew 拒绝安装 -
system "go", "build", ...是最安全方式；避免go install，因它依赖GOPATH且可能污染缓存 - 如果项目没
./cmd/mycli，而是根目录有main.go，就写./；但强烈建议按 cmd 分离，方便未来扩展子命令
如何让用户用一条命令启用你的 Tap
用户执行 brew tap yourname/mytap，Brew 就会克隆 https://github.com/yourname/homebrew-mytap（注意命名固定为 homebrew- 前缀）。这个仓库只放 Formula，**不能混入源码或文档**。
- 仓库名必须是
homebrew-xxx，且公开（Brew 不支持私有 Tap） - Formula 文件名必须全小写、用连字符分隔，如
mycli.rb，对应类名首字母大写驼峰（Mycli） - 用户装工具时运行
brew install yourname/mytap/mycli，不是brew install mycli——除非他们先brew tap-add yourname/mytap再brew tap-pin - 别在 README 里写“请先
brew tap”，直接给完整命令：brew tap yourname/mytap && brew install yourname/mytap/mycli
发布后更新版本为什么总失败
常见错误不是代码问题，而是 Formula 和实际发布不一致：Tag 推了，Formula 没改；或者 sha256 算错了；又或者 GitHub Release 的 tar.gz 被删了（Archive 链接失效）。
- 每次发版前，先用
curl -L [url] | shasum -a 256重算哈希，别复制旧值 - 别用
git tag -f强制覆盖已推 Tag——Brew 缓存可能卡住，用户brew update后仍拉旧版 - 测试更新流程：本地
brew uninstall mycli→brew tap-uninstall yourname/mytap→ 重新tap→install，跳过缓存干扰 - 如果你用
goreleaser，它能自动生成 Formula，但生成结果需人工校验：url是否指向 archive、sha256是否匹配、build路径是否正确——机器不会懂你的项目结构
最麻烦的永远不是第一次发布，而是每次改 Formula 时手抖少敲一个字符，或者忘了推 Tag。把 shasum 和 curl -I 检查 URL 状态写成发布 checklist 里的固定动作，比事后 debug 省半小时。
