Go 要求同一目录下所有 .go 文件必须声明相同的包名，但该包名不必与目录名一致；唯一强制要求是：可执行程序的入口文件（如 main.go）必须属于 package main，且该包内需包含 func main() 函数。
go 要求同一目录下所有 `.go` 文件必须声明相同的包名，但该包名不必与目录名一致；唯一强制要求是：可执行程序的入口文件（如 `main.go`）必须属于 `package main`，且该包内需包含 `func main()` 函数。
在 Go 语言中，包名（package 声明）与目录名之间没有语法绑定关系，但存在强烈约定和工程实践约束：
- ✅ 同一目录下的所有
.go文件必须使用相同的包名 —— 这是 Go 编译器的硬性要求，否则会报错package "xxx" is not in GOROOT或found packages xxx and yyy in directory。 - ✅ 包名通常与目录名保持一致 —— 这是 Go 官方推荐的命名惯例（见 Effective Go），有利于代码可读性、工具链支持（如
go list, IDE 导航）和模块化设计。 - ⚠️ 包名可以不同于目录名 —— 只要语义合理且不违反编译规则。最典型的例外就是
package main。
为什么 util/roms.go 和根目录的 main.go 都用 package main？
因为它们各自被设计为独立可执行的命令行工具：
-
main.go（位于项目根目录）是 NES 模拟器的主程序入口：// main.go package main import "github.com/fogleman/nes/nes" func main() { nes.Run() }执行
go run main.go即启动模拟器。 -
util/roms.go是一个辅助工具，用于批量验证或处理 ROM 文件：// util/roms.go package main // ← 关键：必须为 main 才能独立运行 import ( "fmt" "os" "github.com/fogleman/nes/nes" ) func main() { if len(os.Args) < 2 { fmt.Fprintln(os.Stderr, "usage: roms <roms-dir>") os.Exit(1) } nes.ScanROMs(os.Args[1]) }可直接在
util/目录下运行：cd util go run roms.go ../roms/
? 核心原则：只有
package main中定义了func main()的 Go 程序，才能被go run或go build编译为可执行文件。无论它位于哪个子目录，只要满足此条件，就是独立命令。
注意事项与最佳实践
- ❌ 不要在库目录（如
nes/、util/）中混入多个package main文件 —— 同一目录下若存在多个main包文件，go run *.go会因无法确定入口而失败。 - ✅ 若某目录下同时含库代码与 CLI 工具，建议拆分为子目录（如
util/cmd/roms/），或使用构建标签（//go:build cmd）隔离。 - ✅ 使用
go list -f '{{.Name}}' .可快速检查当前目录的包名，避免手动误判。 - ?
go mod init创建模块时，模块路径（如github.com/fogleman/nes）与包名无关，仅影响导入路径；实际导入仍以import "github.com/fogleman/nes/nes"形式引用nes包。
总之，package main 是 Go 的“可执行契约”，而非目录命名规范。理解这一机制，有助于你灵活组织多工具、多入口的 Go 项目结构。
