Golang init函数什么时候被调用

init函数在main之前、包变量初始化之后执行，顺序为const→var→init→main；同一文件内多个init按代码顺序执行，跨包则依依赖图决定，且仅执行一次。

init 函数在 main 之前、包变量初始化之后立即执行

init 函数不是“随包导入就立刻执行”，而是严格嵌入 Go 程序的初始化流水线中：同一源文件内，执行顺序固定为 const → var（含带函数调用的变量初始化）→ init → main。这意味着哪怕你在 var 声明里调用了某个函数，那个函数也一定先于任何 init 执行。

package main

import "fmt"

func initA() int {
    fmt.Println("→ var 初始化阶段：initA() 被调用")
    return 1
}

var x = initA() // 这行会先执行！

func init() {
    fmt.Println("→ init 阶段：第一个 init()")
}

func init() {
    fmt.Println("→ init 阶段：第二个 init()")
}

func main() {
    fmt.Println("→ main 阶段")
}

运行输出：

→ var 初始化阶段：initA() 被调用
→ init 阶段：第一个 init()
→ init 阶段：第二个 init()
→ main 阶段

跨包 init 的执行顺序由依赖图决定，而非 import 语句顺序

你写 import "net/http" 和 import "database/sql" 的先后，并不控制它们的 init 执行顺序；真正起作用的是它们之间的导入依赖关系。例如：database/sql 内部导入了 net/url，而 net/url 又依赖 net，那么 net 的 init 一定最早执行，database/sql 的 init 最晚。

• 一个包被多次 import（比如被 A 和 B 同时导入），它的 init 仍只执行一次
• 循环 import 会导致编译失败，Go 不允许这种依赖结构
• 用 import _ "xxx" 是为了触发其 init（如注册驱动），但不会引入包符号

同一个文件里多个 init 函数按代码书写顺序执行

这是少数有明确顺序保障的地方：Go 编译器会按源码中 func init() 出现的先后顺序依次调用。但注意——这仅限于**单个 .go 文件内**；如果两个 init 分别在 a.go 和 b.go 中，Go 规范不保证执行顺序（实际按文件名字典序，但不应依赖）。

• 适合拆分逻辑：比如 init 1 加载配置，init 2 注册 handler，init 3 初始化 DB 连接池
• 不要在后一个 init 里假设前一个已“完全就绪”——尤其涉及 goroutine 或异步操作时
• 若需强顺序依赖，应合并为一个 init，或改用显式初始化函数 + 懒加载

init 不能被调用、不能被引用，也不是“构造函数”

init 不是 __init__，也不是类构造器。它没有参数、无返回值、无法赋值给变量、不能出现在表达式中——任何尝试都会导致编译错误，例如 var f = init 或 fmt.Printf("%p", init) 都非法。

• 常见误用：想“重跑 init”来重置状态 → 不可能，必须手动封装可重复调用的初始化函数
• 调试困难点：init 中 panic 会直接终止程序，且堆栈不显示调用链（因为没 caller）
• 测试隐患：单元测试中难以 mock 或跳过 init 行为，建议把核心逻辑抽离到普通函数中

真正容易被忽略的是：init 阶段所有代码都在同一个 goroutine 中同步执行，且不允许阻塞（比如死等 channel、无限 for 循环）。一旦卡住，整个程序启动就挂住，连 main 都见不到——这种问题在线上环境极难定位。