go 语言要求同一目录下所有 .go 文件声明相同包名，但该包名无需与目录名一致；关键在于语义正确性——只有可执行程序才需使用 package main，且必须包含 func main()，此时目录名仅是组织逻辑的标识，不影响编译运行。
go 语言要求同一目录下所有 .go 文件声明相同包名，但该包名无需与目录名一致；关键在于语义正确性——只有可执行程序才需使用 package main，且必须包含 func main()，此时目录名仅是组织逻辑的标识，不影响编译运行。
在 Go 项目结构中，“目录名”和“包名”承担不同职责：
-
目录名用于文件系统组织、模块划分和 import 路径（如
import "github.com/fogleman/nes/ui"）； -
包名则定义代码的编译单元与作用域，决定符号可见性（如
nes.Console中的nes即包名），并约束可执行性。
✅ 正确实践的核心规则是：
- 若某目录下希望构建为独立可执行命令（即能通过
go run xxx.go或go build生成二进制），则其中至少一个.go文件必须声明package main，且整个目录内所有.go文件都必须是package main（Go 强制要求同目录包名统一）； -
package main是 Go 的特殊约定：它不导出任何包级标识符（如main.Foo无效），仅提供入口函数func main()，由go run/go build识别为程序起点。
以 fogleman/nes 为例：
nes/目录下所有文件（cpu.go,ppu.go等）均使用package nes—— 这是一个可复用库包，供其他程序导入（如import "github.com/fogleman/nes/nes"），其目录名nes与包名一致，符合 Go 社区惯例，提升可读性；-
util/roms.go单独使用package main，是因为它被设计为独立工具脚本：// util/roms.go package main import ( "fmt" "os" "github.com/fogleman/nes/nes" // 导入主库包 ) func main() { if len(os.Args) < 2 { fmt.Println("Usage: go run roms.go <roms-dir>") return } // ... 解析 ROM 目录并验证 }执行时无需进入
util/目录，直接在项目根目录运行：go run util/roms.go ./test-roms/
此时 Go 工具链自动识别
util/roms.go为main包，并链接其依赖（如nes包），成功构建临时可执行程序。
⚠️ 注意事项：
- 同一目录下混用不同包名会触发编译错误：
./roms.go:1:1: package main; expected nes； -
main.go放在项目根目录（而非nes/下）却用package main，正是为了将整个 NES 模拟器作为顶层命令行应用启动（如go run main.go game.nes），此时它与nes/子包形成“主程序 + 库”的清晰分层； - 包名应小写、简洁、语义明确（如
main,nes,ui,util），避免下划线或驼峰，且不要与标准库包名冲突（如不可命名为http,fmt）。
总结：包名服务于编译模型与运行语义，目录名服务于工程结构与导入路径。package main 的存在不是为了匹配目录名，而是明确宣告“此处是程序入口”——这是 Go 类型安全与构建简洁性的关键设计。
