func main() 必须无参数无返回值，否则链接失败；它是被 runtime.main 调用的普通函数，需在全局初始化和所有 init() 执行完毕后才运行；多文件项目中须同属 package main 且仅一个 main 函数；main 返回后进程立即终止，goroutine 不等待。
func main() 必须无参数无返回值，否则链接失败
Go 的 main 函数不是运行时才检查，而是链接阶段硬性匹配符号 main.main。只要签名不对——比如写成 func main(args []string) 或 func main() int——go build 就会直接报 undefined reference to main.main，根本不出二进制文件。
这不是语法错误，编译器允许它存在（因为函数定义本身合法），但链接器只认零参数零返回这一种 ABI 约定。常见诱因是从 Python/C 习惯带参写法，结果卡在构建环节，还误以为是运行时报错。
- 命令行参数必须用
os.Args或flag包显式读取，不能塞进main签名里 - 想设退出码？不能靠 return，得调
os.Exit(n) - 把
func main()写在非package main里，它只是个普通函数，go run .会静默忽略或报no Go files in current directory
main 不是第一行代码：runtime.main 才是真实入口
你写的 main 函数，其实是被 runtime.main 调用的。在它执行之前，Go 运行时必须完成三件事：全局变量初始化 → 所有 init() 按依赖顺序执行 → 调度器准备就绪。任一环节卡住或 panic，程序就停在那儿，连你 main 里的第一行 fmt.Println 都不会跑。
典型卡点包括：init 里同步发 HTTP 请求、读未就绪配置文件、向无缓冲 chan 发送、对 nil map 赋值。这些 panic 不会出现在堆栈里，因为 main 根本没开始。
-
init函数不能defer、不能recover，panic 直接终止进程 - 调试建议：用
go tool compile -S main.go看汇编确认入口是runtime.main；再用gdb ./main -ex "b runtime.main" -ex r单步跟进
多文件项目中 main 函数的位置和调用限制
同一目录下所有 .go 文件必须声明 package main，且整个项目只能有一个 func main()。其他函数可以分散在不同文件，但必须同包才能互相调用。
错误示范：只运行 go run main.go，而业务函数写在 helper.go 里——go run 默认只编译指定文件，main.go 里调用的函数会报 undefined。
- 正确做法是
go run .（当前目录全部.go文件）或显式列出所有文件：go run main.go helper.go - 更推荐把业务逻辑抽到独立包（如
package app），main.go只留最简入口，避免main包膨胀和初始化顺序混乱
main 函数返回后，goroutine 并不等待
main 函数返回 ≠ 程序优雅结束。一旦 main 返回，整个进程立即终止，正在运行的 goroutine（哪怕刚启一个 go http.ListenAndServe）会被粗暴中断，没有机会收尾。
如果你的服务需要关闭数据库连接、刷缓存、等请求处理完，不能依赖 main 自然退出。得自己控制生命周期，比如监听 os.Interrupt，用 context.WithTimeout 主动关停子 goroutine。
最容易被忽略的一点：没有显式关机逻辑时，kill -2 和 panic 崩溃表现一致——都是进程瞬间消失，中间状态全丢。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
