init函数在Go中用于包初始化，自动执行且每包仅运行一次。先初始化包级变量，再按文件字母序及代码顺序执行init函数，依赖包优先初始化。适用于注册、配置等前置操作，应避免耗时或引发panic。

在Golang中，init函数是一个特殊函数，用于包的初始化工作。它不需要手动调用，在程序启动时由Go运行时自动执行。理解init函数的执行机制和调用顺序，对编写稳定、可预测的Go程序非常重要。

init函数的基本特性

init函数有以下几个关键特点：

• 函数名必须是init，且不能有参数和返回值
• 可以在一个包中定义多个init函数，分布在不同的源文件中
• init函数在包被导入时自动执行，先于main函数运行
• 即使包被多次导入，其init函数也只执行一次

例如：

func init() {
    fmt.Println("初始化逻辑")
}

包初始化的执行顺序

Go语言严格按照依赖关系和声明顺序执行初始化。整个过程分为两个阶段：变量初始化和init函数调用。

• 先初始化包级变量（包括常量和全局变量），按它们在代码中出现的顺序执行
• 然后按源文件中init函数的声明顺序依次执行
• 如果一个包导入了其他包，则被导入的包会先完成初始化

这意味着：依赖的包总是先于当前包完成初始化。比如main包导入了utils包，那么utils包的init会先执行。

立即学习“go语言免费学习笔记（深入）”；

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

多个init函数的执行顺序

当一个包中有多个init函数（通常分布在不同.go文件中），它们的执行顺序遵循以下规则：

• 按源文件的字母顺序排序后，依次执行每个文件中的init函数
• 同一文件内的多个init函数，按代码书写顺序执行

提示：不要依赖init函数的执行顺序来实现关键业务逻辑，这会降低代码可读性和可维护性。

实际使用建议与注意事项

init函数适合用于注册驱动、设置配置、验证环境等前置操作。

• 数据库驱动注册（如sql.Register）通常放在init中
• 命令行工具中注册子命令
• 全局状态的预设或校验

但应避免在init中做耗时操作或引发panic，否则会影响程序启动。同时，尽量减少跨包的init依赖，防止出现难以排查的初始化问题。

基本上就这些。掌握init函数的调用时机和顺序，能帮助你更好地组织包级初始化逻辑，写出更健壮的Go代码。