17370845950

Go包结构由包名、目录名、导入路径三者共同决定：包名声明于.go文件首行，main包为程序入口；导入路径指定查找位置，可与包名不同；导出标识靠首字母大小写；init函数自动执行初始化。

Go语言的包（package）不是抽象概念，而是直接对应文件系统目录和源码组织方式。理解它的基本结构，关键在于抓住“包名、目录名、导入路径”三者的关系，以及它们如何共同决定代码能否被正确识别和调用。

每个.go文件必须以package声明开头

这是硬性规则：所有Go源文件第一行（非注释）必须是package xxx。这个xxx就是该文件所属的包名。

• main包是程序入口，必须含func main()，编译后生成可执行文件
• 非main包用于封装功能，比如utils、model、httpclient
• 包名建议全小写、简洁，通常与所在目录名一致（但不强制）
• 同一目录下所有.go文件必须声明相同的包名

包名 ≠ 导入路径

这是初学者最易混淆的一点。包名是你在代码里调用函数时用的前缀，比如fmt.Println中的fmt；而导入路径是import语句里写的字符串，代表从哪里找到这个包。

• 标准库如"fmt"、"net/http"，导入路径就是包名本身
• 自定义包的导入路径基于模块根目录。例如项目初始化为go mod init myapp，你在myapp/db目录下写包，则导入路径是"myapp/db"，但包声明仍是package db
• 导入路径可以和包名不同——比如import sql "database/sql"，调用时就得用sql.Open

导出规则由首字母大小写控制

Go没有public/private关键字，是否能被其他包使用，只看名字首字母：

• 首字母大写（如Reverse、Config、ErrInvalid）→ 可导出，外部可访问
• 首字母小写（如helper、parseJSON）→ 仅本包内可用
• 这个规则适用于函数、变量、常量、类型、方法——统一、简单、无例外

init函数是隐式执行的初始化钩子

每个.go文件可定义零个或多个func init()，它没有参数、没有返回值，不能被手动调用。

• 程序启动时自动执行，顺序由依赖关系和文件名共同决定（不建议强依赖顺序）
• 常用于注册驱动、预加载配置、初始化全局变量等一次性操作
• 匿名导入import _ "some/pkg"就是为触发其init而不使用其导出内容

基本上就这些。包结构看似简单，但正是这种明确的目录映射、严格的命名导出、清晰的导入路径分层，让Go项目天然具备良好的可读性和可维护性。