Go 项目虽默认只允许一个 `main` 函数，但可通过多 `cmd/` 子目录或 CLI 框架（如 Cobra）实现多个可独立编译、调用的命令，完美替代 Python 中随意运行任意脚本的灵活性。
在 Go 工程实践中，“一个项目只能有一个 main” 是常见误解。实际上，Go 鼓励将不同用途的可执行程序组织为独立的 main 包，通常放在 cmd/ 目录下——这是 Go 社区广泛采纳的标准项目结构（参考 Perkeep 和 Ben Johnson 的结构化指南）。
✅ 推荐方案一：多 cmd/ 目录 + 独立 main 包
在项目根目录下创建 cmd/ 文件夹，每个子命令对应一个独立可执行文件：
myproject/ ├── cmd/ │ ├── server/ # 主服务：go run cmd/server/main.go │ │ └── main.go │ ├── backup/ # 定时备份脚本：go run cmd/backup/main.go │ │ └── main.go │ └── migrate/ # 数据库迁移：go run cmd/migrate/main.go │ └── main.go ├── internal/ # 共享逻辑（不可导出） ├── pkg/ # 可复用的公共包（可导出） └── go.mod
每个 cmd/*/main.go 都是完整 package main，拥有自己的 func main() 和专属 flag 解析逻辑。例如 cmd/backup/main.go：
package main
import (
"flag"
"fmt"
"log"
"myproject/internal/backup"
)
func main() {
dryRun := flag.Bool("dry-run", false, "print actions without executing")
target := flag.String("target", "prod", "backup target environment")
flag.Parse()
if err := backup.Run(*target, *dryRun); err != nil {
log.Fatal(err)
}
fmt.Println("✅ Backup completed.")
}这样，你可直接通过 go run cmd/backup/main.go --target=staging --dry-run 运行，也可构建为独立二进制：go build -o bin/backup cmd/backup/main.go，再由 cron 调用：0 2 * * * /path/to/bin/backup --target=prod。
✅ 推荐方案二：单二进制 + 多子命令（Cobra）
若偏好统一入口（如 myapp server / myapp backup），推荐使用 spf13/cobra。它提供声明式 CLI 构建能力，自动处理嵌套命令、帮助文档、flag 绑定与子命令隔离：
// cmd/root.go
var rootCmd = &cobra.Command{
Use: "myapp",
Short: "My awesome Go application",
}
func Execute() {
if err := rootCmd.Execute(); err != nil {
os.Exit(1)
}
}// cmd/backup.go
var backupCmd = &cobra.Command{
Use: "backup",
Short: "Run database backup",
Run: func(cmd *cobra.Command, args []string) {
target, _ := cmd.Flags().GetString("target")
dryRun, _ := cmd.Flags().GetBool("dry-run")
if err := backup.Run(target, dryRun); err != nil {
log.Fatal(err)
}
},
}
func init() {
backupCmd.Flags().String("target", "prod", "target environment")
backupCmd.Flags().Bool("dry-run", false, "simulate without writing")
rootCmd.AddCommand(backupCmd)
}构建后统一调用：
go build -o bin/myapp cmd/*.go
→ bin/myapp backup --target=staging --dry-run
→ bin/myapp server --port=8080 --debug
⚠️ 注意事项
- 避免在 main.go 中堆砌大量 if flag == "xxx" 分支逻辑——这违背单一职责，也难以维护和测试；
- 所有业务逻辑应抽离至 internal/ 或 pkg/，cmd/ 层仅负责参数解析与流程调度；
- 使用 Cobra 时，务必为每个子命令设置清晰的 Short/Long 描述，myapp backup --help 应自动生成专业文档；
- Cron 脚本建议使用绝对路径 + 显式环境变量（如 PATH=/usr/local/bin:/usr/bin），避免因环境差异导致失败。
总结：Go 的“多入口”不是妥协，而是工程化的体现——用目录结构表达意图，用独立编译保障隔离，用 CLI 框架提升体验。选择 cmd/ 多包适合职责清晰、部署分散的场景；选择 Cobra 则适合需要统一分发、强品牌一致性或复杂交互的 CLI 工具。
