Go不允许同一目录存在多个main函数，必须通过cmd/子目录隔离、构建标签或主分发函数实现多入口；错误源于构建器检测到多个package main，正确做法是每个入口独占子目录或用-tags控制。
go 语言不允许一个构建单元里存在多个 main 函数，但“多个入口”本身是常见且合理的需求——关键在于把它们拆成独立的构建目标，而不是塞进同一个包或目录。
为什么直接放多个 main.go 在同一目录会报 build: multiple main packages
Go 构建器扫描当前目录下所有 .go 文件，只要发现两个及以上文件声明 package main 并含 func main()，就立刻拒绝。这不是 bug，而是设计约束：每个可执行文件必须有唯一入口点。
- 错误现象：在
cmd/下放了server.go和cli.go，都写package main，然后执行go build就失败 - 别指望靠文件名绕过——
xxx_test.go里写了package main+main()，照样参与构建 - 也别依赖 IDE 自动识别；Go 工具链只认包声明和函数签名，不看文件用途
用 cmd/ 子目录隔离不同 main 包
这是最主流、最符合 Go 工程习惯的做法：每个子命令或服务独占一个子目录，各自为政，互不干扰。
- 目录结构示例：
cmd/api/main.go、cmd/cli/main.go、cmd/worker/main.go，每个都是独立的package main - 构建指定入口：
go build -o bin/api ./cmd/api、go build -o bin/cli ./cmd/cli - 运行时互不影响：
./bin/api启动 HTTP 服务，./bin/cli migrate执行数据库迁移，完全解耦 - 共享逻辑放
internal/或pkg/：配置加载、日志初始化等复用代码不能放在cmd/下，否则会触发 import cycle
用构建约束（//go:build）按需启用某个 main
适合轻量 CLI 工具，想打包成单个二进制但支持多子命令（如 mytool serve / mytool version），又不想拆目录。
AI舌诊面诊问诊医疗系统+诊疗商城系统源码
下载
AI 舌诊面诊问诊医疗系统 + 诊疗商城系统源码是一套结合 AI 辅助诊断与商品转化的健康类程序，基于浩创云、ThinkPHP（PHP）开发，支持微信服务号与 H5 端，适合做中医舌诊面诊问答、健康建议推送以及配套诊疗商品的运营。
- 所有入口逻辑写在不同文件里，但用构建标签控制是否生效：
//go:build serve、//go:build version - 构建时加
-tags指定启用哪个：go build -tags serve -o bin/mytool . - 注意：所有带
//go:build的文件必须在同一目录下，且不能同时满足多个标签条件，否则仍会冲突 - 调试时容易漏掉
-tags导致no buildable Go source files错误——先确认go list -f '{{.Name}}' -tags=xxx .是否输出main
用主 main.go 分发调用其他包的 Main() 函数
本质是放弃多个 package main，改用单入口 + 显式分发。适合逻辑高度耦合、启动流程几乎一致的场景。
- 主
main.go不写业务逻辑，只解析os.Args[1]，然后调用api.Main()、cli.Main()等 - 被调用的包用普通包名（如
package api），导出大写Main()函数，不声明package main - 优势是共享初始化代码方便；劣势是所有功能被打包进一个二进制，无法单独部署或权限隔离
- 注意：
os.Exit(0)必须由各Main()自行调用，主main()不应提前 return
真正容易被忽略的是构建路径语义：go build -o 后面是输出路径，最后那个参数才是输入位置——写成 go build -o ./bin/app ./cmd/api/ 是对的，写成 go build -o ./cmd/api ./bin/app 就会找不到源码。路径错一位，报错就完全跑偏。
