go程序必须有且仅有一个func main(),位于package main中,无参数无返回值;编译器硬性检查,违反即报错。

main函数是Go程序的强制入口,没有它连编译都过不了
Go语言不接受“可选入口”这种说法:func main() 必须存在、必须在 package main 中、签名必须严格为 func main()(无参数、无返回值)。这不是约定,是编译器硬性检查——哪怕只多写一个 int 参数,go build 就直接报错:function main must have no arguments and no return values。
- 把
main()写在package utils里?→ 编译成功但生成的是库(.a 文件),不是可执行文件 - 同一目录下两个
.go文件都写了package main和func main()?→ 编译失败:multiple main functions - 想用
func main(args []string)接收命令行参数?→ 不行,得改用os.Args或flag包
为什么必须是 package main?它和文件路径无关
package main 是 Go 的语法标记,不是目录名或项目名。你完全可以把 main.go 放在 ./cmd/server/ 或 ./app/ 下,只要它的第一行是 package main,go build 就能识别为可执行程序。
- 错误认知:“我把文件放在根目录,就自动是 main 包” → 实际取决于源码首行声明,跟位置完全无关
- 常见误操作:在
./internal/或./pkg/目录下新建main.go却忘了改包名为main→ 编译出的是库,运行时报cannot run program: no main package -
go build ./cmd/api能成功,是因为该目录下有package main,而不是因为路径含cmd
main函数执行前发生了什么?init() 函数的隐式调用顺序
在 func main() 第一行代码执行前,Go 已经完成了所有包的初始化:先按依赖顺序导入包,再按文件名**字典序**执行每个包里的所有 init() 函数(包括 main 包自身的 init())。
-
init()没有参数、无返回值、不能被显式调用,一个包里可以写多个,它们按文件名 a.go、b.go… 顺序执行 - 典型用途:注册驱动(如
database/sql)、预热全局变量、读取配置文件 —— 这些事不能等main()开始后再做 - 陷阱:若
init()中 panic,程序直接终止,且不会进入main();错误堆栈里可能看不到你写的main(),容易误判
main函数退出后,程序真的结束了吗?goroutine 的生死线
func main() 返回的那一刻,整个 Go 程序立即退出,**不管还有多少 goroutine 在跑**。这和很多语言的“主线程结束但其他线程继续”完全不同。
立即学习“go语言免费学习笔记(深入)”;
- 常见错误:在
main()里起一个go http.ListenAndServe(...),然后没加select{}或sync.WaitGroup就直接返回 → 程序秒退,服务根本没起来 - 正确做法:要么阻塞住
main()(比如http.ListenAndServe本身会阻塞),要么用sync.WaitGroup等待关键 goroutine 完成,或用signal.Notify响应中断 - 注意:
defer在main()返回前会执行,但 defer 里启动的新 goroutine 仍会被强制终止
最容易被忽略的一点:Go 的入口机制是编译期强约束 + 运行期单点控制。它不靠配置文件、不靠反射注册、不支持多入口——这种“简单粗暴”恰恰是稳定性的来源,但也意味着任何绕过 package main + func main() 的尝试,都会在第一步就被拦死。










