go程序必须且只能有一个无参数无返回值的func main()，定义在package main中，否则编译或链接失败；多个main函数、错误签名、_test.go中的main均触发构建错误；main执行前已执行包初始化和init函数；测试应抽离核心逻辑而非直接测main。
Go 程序必须且只能有一个 func main()，它必须定义在 package main 中，无参数、无返回值——不满足任一条件，编译或链接阶段就会失败。
为什么 func main() 不能带参数或返回值
这不是风格建议，而是链接器（cmd/link）和运行时的硬性约定。Go 编译器会严格检查：只有签名完全匹配 func main() 的函数，才会被识别为程序入口。
-
func main(args []string)→ 编译通过，但链接时报错：undefined reference to main.main -
func main() int或func main() error→ 同样链接失败，因为运行时只寻找零参数零返回的符号 - 命令行参数必须通过
os.Args或flag包显式读取，不是靠函数签名传递
多个 main 函数导致 build: multiple main packages
Go 构建器扫描整个目录（含所有 .go 文件），只要发现两个及以上文件声明 package main 并含 func main()，就立即中止构建。
- 哪怕文件名是
server.go和cli.go，同属一个目录就冲突 -
_test.go文件里写了package main+main，也会参与构建、触发报错 - 正确解法是拆子目录：
cmd/api/main.go、cmd/cli/main.go，各自独立构建
main 执行前其实已经做了很多事
你写的 main() 不是第一行执行的 Go 代码。runtime 在调用它之前，已按顺序完成：
- 递归初始化所有依赖包（如
fmt的init一定先于你的包） - 执行本包内所有包级
const→var→init()（同一文件多个init按书写顺序） - 若某个
init函数 panic（比如向 nil map 写入），程序会在进入main前崩溃，堆栈里甚至不出现main
测试时想覆盖 main 逻辑？别直接测 main
Go 不允许在 package main 中写 TestMain，也不能用 go test 直接运行 main 函数。实际做法是：
- 把核心逻辑抽成普通函数（如
RunServer()、ParseFlags()），放在internal/或cmd/xxx/子包中 - 在
main.go里只做最简分发：RunServer(os.Args) - 测试时 import 对应包，直接调用导出函数，避免启动开销和副作用
真正容易被忽略的是：即使 main 函数体为空，整个初始化链路（包括所有 init 和运行时准备）仍会完整执行——这决定了冷启动耗时下限，也意味着 init 阶段的阻塞或 panic 会让你根本看不到 main 的第一行调试输出。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
