wire 是编译期依赖注入工具，核心要求是：wire.go 文件须带 // +build wireinject 标签且与主包同级，仅含 injector 函数和显式列出整条依赖链的 wire.build() 调用，生成的 wire_gen.go 必须提交 git。
Wire 不是运行时容器，它不“管理”依赖生命周期，只在编译前生成硬编码的初始化链；微服务里用 Wire，核心就两件事：把 wire.go 放对位置、确保 wire.Build() 列全所有环节。
wire.go 文件必须带 // +build wireinject 且位置严格
这个标签不是注释，是 Go 构建约束。没它，wire build 和 go build 都会跳过该文件，报错是 no injector found 或静默无输出。
- 第一行必须是
// +build wireinject（前面不能有空格，不能加逗号或额外单词） - 文件必须和目标包同级：比如微服务入口在
cmd/user-service/main.go，那wire.go就得放在cmd/user-service/wire.go，不能丢到项目根目录或internal/下无关子包里 - 文件里只放 injector 函数（如
InitializeUserService()）和wire.Build()调用，别写log.Println、别 importgithub.com/some/unused
wire.Build() 漏传 provider 会导致编译失败但报错位置误导
Wire 不扫描整个项目，只认 wire.Build() 显式列出的函数。漏掉中间一环，比如 Service 依赖 Repository，但 wire.Build(InitializeUserService, NewService) 里没列 NewRepository，生成的 wire_gen.go 就会缺失 NewRepository 调用，最终报错指向 undefined: NewRepository，而不是“你漏了 NewRepository”。
- 必须显式列出整条链：如果
UserService → UserServiceImpl → UserRepository → *sql.DB，就得写wire.Build(InitializeUserService, NewUserServiceImpl, NewUserRepository, NewDB) - 参数依赖也要覆盖：比如
NewDB(cfg Config)，就得确保Config要么由另一个 provider 返回，要么用wire.Value(Config{...})注入 - 两个 provider 都返回
*redis.Client？Wire 直接报错。得用wire.Struct绑定字段，或用wire.Value区分用途（如缓存 client 和锁 client）
生成的 wire_gen.go 必须提交进 Git
它不是临时文件，而是构建链的硬依赖。CI 流水线里漏跑 wire build，或本地 .gitignore 把它过滤了，新同事拉代码后 go run main.go 就会报 undefined: InitializeUserService。
-
wire_gen.go内容就是手写风格的初始化代码，可跳转、可调试、无反射开销 - 每次修改
wire.go后，必须手动执行wire（或集成进go generate）重新生成，并提交变更 - provider 函数里禁止做
db.Ping()、启 goroutine、读配置文件——Wire 不校验这些，但会在服务启动时直接 panic
最常被忽略的是 provider 函数签名：返回类型必须和依赖字段完全一致，*sql.DB ≠ database/sql.DB，也不等于未导出别名 type DB *sql.DB；函数名必须首字母大写，NewDB ✅，newDB ❌。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
