Go 项目可通过 cmd/ 目录下多个 main 包实现多命令分发，无需根目录 main.go；使用 go install ./... 即可批量构建所有命令，每个 main 包生成独立可执行文件。

go 项目可通过 `cmd/` 目录下多个 `main` 包实现多命令分发，无需根目录 `main.go`；使用 `go install ./...` 即可批量构建所有命令，每个 `main` 包生成独立可执行文件。

在 Go 工程实践中，将不同命令（如 CLI 工具的 serve、migrate、test 等）拆分为独立的 main 包，是清晰、可维护且符合 Go 生态惯例的标准做法。典型结构如下：

myapp/
├── cmd/
│   ├── first/
│   │   └── main.go   // package main, func main()
│   ├── second/
│   │   └── main.go   // package main, func main()
│   └── third/
│       └── main.go   // package main, func main()
├── internal/
│   └── service/      // 业务逻辑，仅被内部引用
├── pkg/
│   └── util/         // 可复用的公共包
└── go.mod

✅ 构建方式
进入项目根目录后，运行：

go install ./...

Go 工具链会递归扫描所有子目录，自动识别含 func main() 的 package main，并为每个匹配包生成独立二进制文件（默认输出到 $GOBIN，通常为 $HOME/go/bin）。例如上述结构将生成：

• $GOBIN/first
• $GOBIN/second
• $GOBIN/third

你也可指定构建单个命令：

go build -o ./bin/first ./cmd/first

✅ 调试与开发流程

• 每个 cmd/* 目录应视为独立程序：各自编写 main.go，导入并调用共享逻辑（如 internal/service 或 pkg/util）；
• 单元测试照常编写于对应包内（如 internal/service/service_test.go），通过 go test ./... 全局运行；
• 调试特定命令时，直接在 cmd/first/ 目录下执行 dlv debug 或 IDE 启动调试器（需配置工作目录为该子目录）；
• 若需集成测试命令行为（如验证 first --help 输出），推荐使用 os/exec.Cmd 模拟调用：

  cmd := exec.Command("../bin/first", "--help")
  out, err := cmd.CombinedOutput()
  if err != nil {
      t.Fatal(err)
  }
  if !strings.Contains(string(out), "Usage:") {
      t.Error("expected help output")
  }

✅ 进阶建议

• 避免重复逻辑：将命令共用的参数解析、日志初始化、配置加载等提取至 internal/cli 等共享包，各 main.go 仅负责路由和启动；
• 推荐 CLI 框架：对于复杂命令（含子命令、flag 分组、自动生成 help/man），强烈推荐 Cobra 或 urfave/cli，它们天然适配多 cmd/ 结构，支持按需注册子命令；
• 版本与构建信息：可在每个 main.go 中注入 git commit、build time 等变量（通过 -ldflags），提升可观测性。

这种结构不仅解耦清晰、利于团队协作，也完全兼容 Go Modules 和现代 CI/CD 流程——每个命令可独立发布、灰度部署或权限管控，是生产级 Go CLI 项目的事实标准。