go程序仅在显式导入（或间接依赖）某个包时才会执行其init()函数；若新包未被任何已启用代码路径导入，即使存在init()，也不会触发。可通过空白标识符导入（import _ "mypackage"）强制初始化。
go程序仅在显式导入（或间接依赖）某个包时才会执行其init()函数；若新包未被任何已启用代码路径导入，即使存在init()，也不会触发。可通过空白标识符导入（import _ "mypackage"）强制初始化。
在Go语言中，init()函数是包级初始化的特殊入口，它在main()函数执行前自动调用，且每个包最多执行一次。但一个关键前提常被忽略：Go只对实际被导入并参与构建的包执行init()。这意味着——即使你新建了一个包含init()函数的包（例如 pkg/logsetup），只要主程序（或其依赖链）中没有import "pkg/logsetup"语句，该包根本不会被链接进最终二进制，其init()自然不会运行。
最常见的误判场景是：开发者创建了新包并写好init()用于配置日志、注册驱动或初始化全局状态，却未在main.go或任一被引用的包中导入它。此时编译无错、运行无提示，但初始化逻辑静默失效。
✅ 正确做法是确保包被导入。若该包仅需执行init()而无需导出任何符号（如函数、变量、类型），应使用空白导入（blank import）：
// main.go
package main
import (
_ "mypackage" // 强制触发 mypackage/init.go 中的 init()
"fmt"
)
func main() {
fmt.Println("started")
}
⚠️ 注意事项：
- 空白导入
_ "mypackage"不会引入包的导出标识符，仅激活其init()链（包括该包所依赖的其他包的init()）； - 若包有副作用（如修改全局变量、启动goroutine、打开文件），请确保这些行为是幂等的或可控的，因为
init()在程序生命周期中仅执行一次，且无法手动重试； - 避免过度依赖
init()做复杂初始化——推荐显式初始化函数（如mypackage.Init()），便于单元测试与依赖控制； - 可通过
go list -f '{{.Imports}}' ./...检查实际构建中哪些包被导入，辅助诊断遗漏。
总结：init()不是“自动发现并执行”的钩子，而是Go构建流程中严格遵循导入图（import graph）的确定性阶段。排查init()不执行，第一步永远应是确认该包是否出现在有效导入路径中——空白导入是解决“纯初始化型包”问题的标准、安全且惯用的方式。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
