go允许项目中存在多个main包，但必须分属不同目录且路径互不冲突；构建时应使用包路径如go build -o app1 ./cmd/app1，而非文件路径，并注意go run需加./前缀及build tags的兼容性。
多个 main 包共存是合法的，但不能放在同一目录下
Go 语言允许一个项目里有多个 main 函数，只要它们分别位于不同目录，且每个目录都是独立的 module 或至少是独立的包路径。常见错误是把两个 main.go 文件直接丢进 cmd/ 同级目录，结果 go build 报错：package main is not a main package 或构建失败 —— 实际上是因为 Go 默认只认当前目录下的 main 包，而多个 main 在同一目录会冲突。
正确做法是按功能拆分入口目录，比如：
-
cmd/app1/下放main.go（含func main()） -
cmd/app2/下放另一个main.go - 每个子目录都保持独立、不含其他
main包
go build -o 指定输出名时，路径必须指向 main 包所在目录
构建单个可执行文件时，go build 的目标不是文件，而是包路径。误写成 go build cmd/app1/main.go 看似能跑，但其实绕过了模块感知，容易漏掉依赖或用错版本；更糟的是，如果该 main.go 引用了本 module 外的本地包（比如 internal/），会直接报 import "xxx/internal" is a program, not an importable package。
应该用包路径构建：
go build -o app1 ./cmd/app1go build -o app2 ./cmd/app2- 路径末尾不加
/main.go，也不加/（加了可能被识别为文件而非包） - 如果项目启用了 Go modules，确保
go.mod在根目录，且cmd/下各子目录没自己建go.mod
用 go run 快速验证多个入口时，别漏掉 ./ 前缀
go run 对路径更敏感。写成 go run cmd/app1 会报错：no Go files in ...，因为 Go 默认只扫描当前目录；必须显式告诉它这是相对路径：go run ./cmd/app1。
这个点容易在 CI 脚本或 Makefile 里翻车，尤其当路径拼接用变量时，忘了加 ./ 就静默失败。
- ✅ 正确：
go run ./cmd/app1 - ❌ 错误：
go run cmd/app1（除非你在cmd/app1目录下执行） - 如果想一次跑多个，得分别调用：
go run ./cmd/app1 && go run ./cmd/app2，Go 不支持go run ./cmd/*
交叉编译和 GOOS/GOARCH 对多 main 包无特殊影响，但要注意 build tags 冲突
给不同平台构建时，GOOS=linux go build -o app1-linux ./cmd/app1 完全可行。真正容易出问题的是 build tags —— 比如你在 cmd/app1/main.go 顶部写了 // +build !windows，又在 cmd/app2/main.go 里写了 // +build windows，那在 Windows 上执行 go build ./cmd/...（带通配）就会因 tag 不匹配跳过某些包，甚至构建空结果。
建议：
- 避免在
main包里用太激进的 build tags，尤其是跨平台逻辑尽量抽到internal/或pkg/ - 如果必须用，确保每个
main包的 tag 是自洽且互斥的 - 用
go list -f '{{.Name}}' -tags=xxx ./cmd/...验证哪些包会被包含
main 包”。 
