本文介绍在 Go 生态中，如何让一个支持 go get 安装的 CLI 工具包（package main）最终生成指定名称的可执行文件（如 foo），而非默认与模块路径或目录名一致的 foo-cli，兼顾仓库可读性与终端使用便捷性。
本文介绍在 go 生态中，如何让一个支持 `go get` 安装的 cli 工具包（`package main`）最终生成指定名称的可执行文件（如 `foo`），而非默认与模块路径或目录名一致的 `foo-cli`，兼顾仓库可读性与终端使用便捷性。
在 Go 的传统工作流中，go get 会自动构建并安装 package main 所在的模块，生成的二进制文件名默认由 go build 推导：若当前目录下只有一个 main.go，则输出名即为当前目录名（如 foo-cli/ → foo-cli）。但实际开发中，我们常希望仓库名保持语义清晰（如 github.com/exaring/foo-cli），而终端命令简短易记（如 foo）。遗憾的是，go get 本身不支持通过参数指定输出二进制名——它不接受 -o 标志，也无法在 go.mod 或构建标签中声明。
不过，有两类实用且符合 Go 工程惯例的解决方案：
✅ 方案一：推荐 —— 使用 go install（Go 1.16+，取代 go get -u）
从 Go 1.16 开始，go install 支持带版本的模块路径，并允许显式指定输出名（需配合 -o）：
# 构建并安装到 GOPATH/bin 或 GOBIN 下，生成名为 'foo' 的可执行文件 go install -o $GOBIN/foo github.com/exaring/foo-cli@latest
⚠️ 注意：-o 仅在 go install（非 go get）中可用，且要求 Go ≥ 1.21（完整支持模块路径 + -o）；早期版本需先 cd 到项目目录再 go build -o foo .。
✅ 方案二：双入口结构（兼容所有 Go 版本）
将核心逻辑封装为独立包（如 github.com/exaring/foo-cli/cmd），并在同一仓库中维护两个 main 包：
炫酷的jQuery二进制数字时钟，它的时分秒都是用二进制来表示，绿色表示该位值是1，灰色则表示0，原理是将时钟的时分秒分别实时转换成二进制，然后随着本地时间的更新而实时刷新
-
cmd/foo-cli/：保留原始 CLI 实现，供go get github.com/exaring/foo-cli/cmd/foo-cli安装为foo-cli -
cmd/foo/：仅含一行import _ "github.com/exaring/foo-cli/cmd/foo-cli"，并定义空main()函数（或直接复用逻辑）
更简洁的做法是：在根目录外单独建一个 cmd/foo/ 目录，内含 main.go 引入主逻辑：
// cmd/foo/main.go
package main
import "github.com/exaring/foo-cli/cli" // 假设 CLI 逻辑已提取至 cli 包
func main() {
cli.Execute() // 调用统一入口
}这样用户运行：
go install github.com/exaring/foo-cli/cmd/foo@latest
即可安装为 foo，且仓库结构清晰、无冗余代码。
⚠️ 注意事项
-
go get（无参数）在 Go 1.17+ 已默认只下载依赖，不再自动构建安装；真正替代它的是go install <module>@<version></version></module>。 - 避免在
main包中硬编码路径或依赖os.Args[0]推断命令名——应通过配置或 flag 显式指定行为。 - 若需发布到 Homebrew 或其他包管理器，建议在
README.md中明确安装命令示例，例如：## Install go install github.com/exaring/foo-cli/cmd/foo@latest
综上，虽然无法让 go get github.com/exaring/foo-cli 直接产出 foo，但通过 go install + 子命令目录的组合，既能保持仓库命名规范，又能提供极简的终端体验——这是当前 Go 社区广泛采用的最佳实践。
