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关键字,是否能被其他包使用,只看名字首字母:
立即学习“go语言免费学习笔记(深入)”;
- 首字母大写(如
Reverse、Config、ErrInvalid)→ 可导出,外部可访问 - 首字母小写(如
helper、parseJSON)→ 仅本包内可用 - 这个规则适用于函数、变量、常量、类型、方法——统一、简单、无例外
init函数是隐式执行的初始化钩子
每个.go文件可定义零个或多个func init(),它没有参数、没有返回值,不能被手动调用。
- 程序启动时自动执行,顺序由依赖关系和文件名共同决定(不建议强依赖顺序)
- 常用于注册驱动、预加载配置、初始化全局变量等一次性操作
- 匿名导入
import _ "some/pkg"就是为触发其init而不使用其导出内容
基本上就这些。包结构看似简单,但正是这种明确的目录映射、严格的命名导出、清晰的导入路径分层,让Go项目天然具备良好的可读性和可维护性。










