Go 语言的 init() 函数在包导入时自动执行且先于 main(),用于包级初始化;它无参数、无返回值、不可显式调用,执行顺序遵循文件内定义序、文件名字典序及依赖顺序;典型用途包括驱动注册、配置加载等,但应避免耗时操作与循环依赖,复杂场景推荐显式初始化函数替代。

Go 语言的 init() 函数会在包被导入时自动执行,且在 main() 函数运行前完成,是执行包级初始化逻辑(如注册、配置加载、全局变量设置等)的标准方式。
init 函数的基本规则
init() 是 Go 中一种特殊函数,每个源文件中可定义多个,但不能带参数、不能有返回值,也不能被显式调用。它由编译器自动安排执行顺序:
- 同一文件内,
init()按定义顺序执行 - 不同文件间,按文件名**字典序**执行(如
a.go先于b.go) - 依赖关系上,被导入包的
init()总是先于当前包执行
典型使用场景与示例
常见用途包括:注册驱动、预热缓存、初始化全局配置、设置日志格式等。
例如,在数据库驱动注册中:
立即学习“go语言免费学习笔记(深入)”;
// mysql_driver.gopackage mysql
import "database/sql"
func init() { sql.Register("mysql", &MySQLDriver{})}
只要其他包导入了 import _ "your-project/mysql",该注册逻辑就会自动生效,无需手动调用。
注意事项与避坑点
init() 执行时机不可控、不可跳过,因此要避免副作用过重或依赖未就绪的外部资源:
- 不要在
init()中做耗时操作(如网络请求、大文件读取),否则会拖慢整个程序启动 - 避免循环依赖:若 A 包
init()间接引用 B 包变量,而 B 又依赖 A,则编译失败 - 多个
init()之间无法传递参数或共享局部状态,需通过包级变量通信 - 测试时,
init()仍会执行,如有副作用,建议用惰性初始化(sync.Once)替代
替代方案:显式初始化更可控
对于复杂初始化逻辑,推荐封装为导出函数,由调用方按需触发:
func SetupDatabase(cfg Config) error { ... }func InitLogger() { ... }
这样既清晰表达了依赖和时机,也便于单元测试和条件初始化(如只在生产环境启用某功能)。










