17370845950

Go程序入口要求：必须声明package main且为文件首行；需含无参无返回值的func main()；文件须为UTF-8编码.go源码；go run .或go build会合并同目录所有main包文件，须确保唯一逻辑入口。

main包必须声明为package main

Go 程序的入口文件必须属于 main 包，且该包声明必须是文件第一行（忽略空行和注释）的 package main。任何其他包名（如 package myapp 或 package main_v2）都会导致 go run 或 go build 报错：main package must be declared。

• 不能用 //go:build 或 // +build 条件编译覆盖包名
• 一个模块中可有多个 package main 文件，但 go run 只接受单个文件或显式指定目录；go build 会把同目录下所有 .go 文件一起编译进二进制
• 如果混入非 main 包文件（比如同一目录下有 utils.go 声明 package utils），go build 会直接失败

main() 函数必须存在且签名严格匹配

入口函数必须是无参数、无返回值的 func main()，定义在 main 包内。大小写敏感，名称拼错（如 Main、main1、func main(args []string)）都会导致链接失败：

./main.go:5:6: missing function body
./main.go:5:6: func main must have no arguments and no return values

• 不能加接收者（即不能是方法）
• 不能用泛型参数（func main[T any]() 不合法）
• 不能放在嵌套作用域（如闭包、if 块内）
• 可以跨多个文件定义（只要都在同一 main 包下），但只能有一个 main() 实现

文件必须能被 Go 工具链识别为可编译源码

入口文件需满足 Go 源码基本规范，否则 go 命令无法解析：

• 文件扩展名必须是 .go（.gox、.golang 等无效）
• 不能是空文件或仅含注释/空白符（go build 会报 no non-test Go files）
• UTF-8 编码，BOM 头会导致解析失败（常见于 Windows 编辑器误保存）
• 若使用 cgo，需确保 // #include 和 import "C" 正确配对，且 C 代码语法无误；否则编译阶段卡在 C 层

构建时路径和模块上下文影响实际“入口”判定

go run 和 go build 对“哪个文件是入口”的判断逻辑不同，容易混淆：

• go run main.go：只编译运行指定文件，忽略同目录其他 .go 文件（除非它们也属 main 包且被导入）
• go run .：编译当前目录下所有 main 包的 .go 文件，要求其中恰好一个含 main()
• go build（无参数）：默认构建当前目录，行为同 go run .
• 若项目启用 Go modules（有 go.mod），且入口文件在子目录（如 cmd/myapp/main.go），必须用 go run cmd/myapp 或 go build ./cmd/myapp，不能直接 go run cmd/myapp/main.go（后者会脱离模块上下文，可能找不到依赖）

真正容易被忽略的是：当目录下存在多个 main 包文件但只有一个是“逻辑主入口”，而你误用 go run .，Go 会静默合并全部，可能导致未预期的 init 执行顺序或符号冲突。