Go语言的包初始化机制是程序运行前的重要准备阶段，它负责完成包级别变量的赋值、init函数的执行等工作，所有包的初始化完成之后，main包的main函数才会开始执行。
包初始化的触发条件
Go中包的初始化不是自动发生的，只有在程序中被实际使用到的包才会触发初始化流程。这里的实际使用包含两种情况：一是包被其他包导入，二是包内的标识符（变量、函数、结构体等）被当前包引用。如果一个包被导入但没有被使用，Go编译器会直接报错，不会触发该包的初始化。
单个包的初始化顺序
对于一个独立的包，初始化的顺序是固定的，按照以下规则依次执行：
- 第一步：初始化包级别的常量，按照常量声明的先后顺序执行
- 第二步：初始化包级别的变量，按照变量声明的先后顺序执行，如果变量有初始值表达式，会先计算表达式的值再赋值
- 第三步：执行包内的所有init函数，同一个包内可以有多个init函数，按照它们在文件中出现的顺序执行，先出现的文件中的init函数先执行
我们可以通过下面的示例代码验证这个顺序：
package testpkg
import "fmt"
// 包级别常量
const ConstA = "const_a"
// 包级别变量
var VarA = func() string {
fmt.Println("初始化变量VarA")
return "var_a"
}()
// init函数1
func init() {
fmt.Println("执行第一个init函数")
}
// 包级别变量
var VarB = func() string {
fmt.Println("初始化变量VarB")
return "var_b"
}()
// init函数2
func init() {
fmt.Println("执行第二个init函数")
}
当这个包被导入时，输出结果会是：
初始化变量VarA 初始化变量VarB 执行第一个init函数 执行第二个init函数
多个包的初始化顺序
当程序中存在多个包的导入关系时，初始化顺序遵循深度优先、导入优先的规则，具体逻辑如下：
- 如果包A导入了包B，那么包B会先于包A初始化
- 如果多个包同时导入同一个包C，那么包C只会初始化一次
- 所有被导入的包都完成初始化之后，导入方包才会开始自己的初始化流程
我们通过一个多包依赖的例子来理解这个顺序，假设包结构如下：
- main包导入了pkg1和pkg2
- pkg1导入了pkg3
- pkg2也导入了pkg3
那么初始化的顺序为：pkg3 → pkg1 → pkg2 → main包。其中pkg3只会被初始化一次，不会因为被两个包导入而初始化两次。
init函数的特性
init函数是Go包初始化机制中的特殊函数，它有以下特性：
- init函数没有参数，也没有返回值，不能在其他地方被显式调用
- 每个包可以有多个init函数，同一个文件也可以有多个init函数
- init函数的执行发生在包初始化阶段，早于main函数的执行
- init函数通常用于完成包级别的初始化工作，比如注册驱动、初始化配置、校验包级别变量的合法性等
下面是一个init函数常见使用场景的示例，模拟驱动注册的逻辑：
package driver
import "fmt"
// 驱动注册表
var drivers = make(map[string]func() string)
// 注册驱动的函数
func Register(name string, initFunc func() string) {
drivers[name] = initFunc
fmt.Printf("注册驱动：%sn", name)
}
// 获取驱动
func GetDriver(name string) func() string {
return drivers[name]
}
package mysql
import (
"fmt"
"testproject/driver"
)
// init函数中注册mysql驱动
func init() {
driver.Register("mysql", func() string {
return "mysql连接初始化完成"
})
fmt.Println("mysql包初始化完成")
}
package main
import (
"fmt"
"testproject/driver"
_ "testproject/mysql" // 匿名导入触发mysql包的初始化
)
func main() {
mysqlDriver := driver.GetDriver("mysql")
if mysqlDriver != nil {
fmt.Println(mysqlDriver())
}
}
运行上面的程序，会先执行mysql包的init函数完成驱动注册，再执行main函数的逻辑，输出结果如下：
注册驱动：mysql mysql包初始化完成 mysql连接初始化完成
常见注意事项
- 不要在init函数中写复杂的业务逻辑，避免延长程序启动时间，也减少初始化阶段出错的概率
- 避免包之间的循环导入，循环导入会导致编译失败，也和初始化顺序的逻辑冲突
- 如果包级别变量的初始化依赖其他包的变量，要确保被依赖的包先完成初始化，也就是正确安排包的导入顺序
- init函数的执行是不可控的，不要在init函数中依赖执行顺序做一些强耦合的逻辑，避免后续调整代码时出现问题
总结
Go的包初始化机制有清晰的执行规则，单个包内按照常量、变量、init函数的顺序执行，多个包之间按照导入的依赖关系深度优先执行，且被多次导入的包只会初始化一次。init函数作为初始化阶段的重要载体，适合做轻量的包级别准备工作，开发者理解这些规则之后，就能更合理地组织包结构，避免出现初始化相关的问题。