分发 CLI 工具
交叉编译、goreleaser 与 homebrew tap
分发 CLI 工具 是 CoddyKit 上的免费 Go Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。
使用 go install 进行本地分发
go install github.com/user/tool@latest 会编译二进制文件，并将其安装到 $GOPATH/bin。用户需要安装 Go。
交叉编译
Go 原生支持交叉编译。请设置 GOOS 和 GOARCH，以面向不同的操作系统：
GOOS=linux GOARCH=amd64 go build -o myapp-linux-amd64
GOOS=darwin GOARCH=arm64 go build -o myapp-darwin-arm64
GOOS=windows GOARCH=amd64 go build -o myapp-windows-amd64.exe发布版本的构建标志
移除调试信息并禁用 CGO，以生成更小的静态二进制文件：
CGO_ENABLED=0 go build -ldflags="-s -w" -o myapp嵌入版本信息
使用 ldflags 注入构建时信息：
var version = "dev"
var commit = "none"
// Build: go build -ldflags="-X main.version=1.2.3 -X main.commit=abc1234"GoReleaser
GoReleaser 可自动完成交叉编译、打包（tar.gz、.zip）、生成校验和以及将发行版本上传到 GitHub。在 .goreleaser.yaml 中进行配置。
# .goreleaser.yaml
builds:
- env: [CGO_ENABLED=0]
goos: [linux, darwin, windows]
goarch: [amd64, arm64]Homebrew tap
发布 Homebrew 公式，让 macOS/Linux 用户可以使用 brew install 安装。GoReleaser 可以自动生成该公式。
GitHub Actions 持续集成与持续交付
使用 GitHub Action，在每次推送标签时进行构建和发布。GoReleaser 提供官方 GitHub Action。
- name: Run GoReleaser
uses: goreleaser/goreleaser-action@v5
with: { version: latest, args: release --clean }
env: { GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}" }使用 Docker 分发
将 CLI 打包为 Docker 镜像，供偏好容器的用户使用。请使用多阶段构建，以保持最终镜像的精简。
FROM golang:1.22 AS build
WORKDIR /app
COPY . .
RUN CGO_ENABLED=0 go build -o myapp
FROM scratch
COPY --from=build /app/myapp /myapp
ENTRYPOINT ["/myapp"]使用 go:embed 嵌入资源
使用 //go:embed 将静态文件（模板、配置架构）嵌入二进制文件，使二进制文件完全自包含。
//go:embed templates/*
var templates embed.FS版本化模块
按照 Go 模块版本规范发布 CLI 模块。对于 v2 及更高版本，导入路径必须包含 /v2，并且 go.mod 模块路径必须匹配。
向后兼容性
请遵循语义化版本规范。次版本发布可以添加标志，但不能移除或重命名现有标志。不兼容的更改需要提升主版本号。
快速检查
如何在 macOS 机器上构建适用于 Linux 的静态 Go 二进制文件？
回顾：分发 CLI 工具
关键要点：
- 使用 GOOS/GOARCH 进行交叉编译；使用 CGO_ENABLED=0 构建静态二进制文件
- 使用 GoReleaser 自动化发布流程
- 使用 -ldflags "-X main.version=..." 注入版本信息
- 使用 go:embed 构建包含嵌入资源的自包含二进制文件
常见问题解答
「分发 CLI 工具」课时是免费的吗？
是的 — 「分发 CLI 工具」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。
「分发 CLI 工具」这节课中我会学到什么？
交叉编译、goreleaser 与 homebrew tap 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Go Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「分发 CLI 工具」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Go Academy 课中编写并运行代码吗？
能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。