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语言免费学习笔记（深入）”；
-
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 执行顺序或符号冲突。
