依赖注入是将对象创建、使用和生命周期管理从代码中解耦并交由 wire 在编译前解析；wire 仅识别带 // +build wireinject 标签的同包 wire.go 文件中的 provider，要求类型唯一、禁止循环依赖，且 wire_gen.go 必须提交至 git。
依赖注入不是“加个框架就自动变松耦合”，而是把谁创建谁、谁用谁、谁管生命周期这些事，从代码里拎出来，交给 Wire 在编译前算清楚。没它，你得手动 New 一串对象再传进去；有它，你只声明“我要一个 App”，Wire 就给你生成按顺序调用 NewDB、NewRabbitMQ、NewHandler 的函数。
为什么 wire.Build() 报错说 provider 找不到？
Wire 不扫描整个项目，只认当前包里带 // +build wireinject 标签的 wire.go 文件，并且只看这个文件里 wire.Build() 的参数列表。常见原因：
-
wire.go没加// +build wireinject—— Go 构建工具直接跳过该文件，wire build根本看不见wire.Build() - provider 函数（比如
NewDB）没导出（首字母小写），Wire 无法访问 - provider 放在别的包里，但没 import 或没用全限定名（如
db.NewDB），wire.Build()里写的只是函数名，不是路径 -
wire.go放错位置：必须和你要生成的 injector 在同一包（比如cmd/myapp/），不能扔在根目录或internal/util/这种无关包里
两个 provider 都返回 *sql.DB 怎么办？
Wire 要求类型唯一性 —— 同一类型只能有一个 provider 直接提供。如果 NewPrimaryDB() 和 NewAuditDB() 都返回 *sql.DB，wire.Build() 会直接报错。
解决方式只有两种：
- 用
wire.Value显式绑定具体实例：wire.Value(primaryDB)，其中primaryDB是已初始化好的*sql.DB变量 - 用
wire.Struct+ 字段标签区分用途，比如定义结构体type DBSet struct { Primary *sql.DB `wire:"primary"`; Audit *sql.DB `wire:"audit"` }，再通过wire.FieldsOf提取
别试图靠函数名或注释绕过 —— Wire 只看签名，不看名字。
wire_gen.go 为什么必须提交到 Git？
它不是临时文件，是编译链硬依赖。CI 流程里漏跑 wire gen，或者本地 .gitignore 误删了 wire_gen.go，新同事 go run main.go 就会报 undefined: InitializeApp —— 因为那个函数根本不存在，是 wire_gen.go 里生成的。
建议在 CI 中加检查：
git diff --quiet || (echo "wire_gen.go out of date"; exit 1)
另外，provider 函数体内不能有副作用（比如 db.Ping() 或启动 goroutine）。Wire 不执行它们，只分析签名；但生成的初始化代码会在程序启动时无条件调用 —— 错误在这里暴露，而不是编译期。
Wire 的复杂点不在语法，而在于依赖图必须是 DAG（有向无环图）。循环依赖不会报错信息友好，往往表现为“找不到某个类型”的模糊提示，得靠 wire show 看完整依赖路径才能定位。别跳过这步。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
