go 程序中新建包的 init() 函数不执行，通常是因为该包未被主程序显式导入；即使包内定义了 init()，若无 import 语句（或仅被间接、未启用的条件编译导入），go 运行时将完全忽略该包及其初始化逻辑。
go 程序中新建包的 init() 函数不执行，通常是因为该包未被主程序显式导入；即使包内定义了 init()，若无 import 语句（或仅被间接、未启用的条件编译导入），go 运行时将完全忽略该包及其初始化逻辑。
在 Go 中，init() 函数的执行严格遵循包导入链：只有被主程序（或其直接/间接依赖）实际导入的包，其 init() 函数才会在程序启动时自动调用。这意味着：
- ✅ 已有包的
init()能运行 → 说明它们已被main或其他已导入包引用； - ❌ 新建包的
init()不运行 → 最可能的原因是：该包未出现在任何import语句中。
正确导入以触发 init()
假设你的新包路径为 github.com/yourname/utils/loginit，且其中定义了：
// loginit/init.go
package loginit
import "fmt"
func init() {
fmt.Println("loginit initialized")
}
若 main.go 中未导入该包，则 init() 永远不会执行：
// main.go —— 错误：未导入，loginit.init() 不会运行
package main
import "fmt"
func main() {
fmt.Println("Hello")
}
✅ 正确做法：添加导入语句。若你仅需执行初始化逻辑，无需使用该包的任何导出标识符（如函数、变量），应使用空白标识符导入：
// main.go —— 正确：_ "github.com/yourname/utils/loginit" 触发 init()
package main
import (
"fmt"
_ "github.com/yourname/utils/loginit" // 注意下划线前缀
)
func main() {
fmt.Println("Hello")
}
// 输出：
// loginit initialized
// Hello
⚠️ 注意事项：
-
import "github.com/yourname/utils/loginit"（无下划线）也可触发init()，但要求你在代码中至少引用一次该包的任意导出名（如loginit.DoSomething()），否则 Go 1.19+ 会报错imported and not used； - 空白导入
_ "path"是 Go 官方支持的惯用法，专为此类“副作用导入”（side-effect imports）设计，常见于数据库驱动注册（如import _ "github.com/lib/pq"）、日志配置初始化等场景； -
init()执行顺序遵循导入依赖图拓扑排序：被依赖包的init()总是在依赖者之前执行，同一包内多个init()按源文件字典序执行。
验证是否生效
可添加简单日志或 panic 测试：
func init() {
fmt.Fprintln(os.Stderr, "[DEBUG] loginit init called")
}
运行 go run main.go 后观察标准错误输出，确认初始化逻辑是否如期触发。
总结：Go 的 init() 不是“全局自动发现”，而是“按需静态链接”。确保新包被 import（显式或空白导入）是解决问题的关键——这不是 bug，而是 Go 编译模型保障构建确定性与最小依赖的核心机制。
