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

Go 语言的 init() 函数会在包被导入时自动执行，且在 main() 函数运行前完成，是执行包级初始化逻辑（如注册、配置加载、全局变量设置等）的标准方式。

init 函数的基本规则

init() 是 Go 中一种特殊函数，每个源文件中可定义多个，但不能带参数、不能有返回值，也不能被显式调用。它由编译器自动安排执行顺序：

• 同一文件内，init() 按定义顺序执行
• 不同文件间，按文件名**字典序**执行（如 a.go 先于 b.go）
• 依赖关系上，被导入包的 init() 总是先于当前包执行

典型使用场景与示例

常见用途包括：注册驱动、预热缓存、初始化全局配置、设置日志格式等。

例如，在数据库驱动注册中：

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

// mysql_driver.go

package mysql

import "database/sql"

Golang Samber Hot

在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。

下载

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() { ... }

这样既清晰表达了依赖和时机，也便于单元测试和条件初始化（如只在生产环境启用某功能）。