wire.Build() 参数必须全为导出的提供者函数，每个依赖类型有且仅有一个返回该类型的provider；基础类型冲突需用类型别名区分；文件须含// +build wireinject构建标签；生成文件不可手动修改；接口注入需provider直接返回接口类型。
wire.Build() 怎么写才不会报错
写 wire.Build() 时，参数必须全是「提供者函数」（provider functions），也就是返回具体类型、参数全是依赖项的函数。它不接受结构体、变量、接口值或带逻辑的闭包。
常见错误现象：wire: injectors.go:12:2: no provider found for *database.DB 或 wire: injectors.go:15:3: multiple providers for string —— 前者是漏写了某个 NewDB()，后者是两个 provider 都返回 string，Wire 无法区分。
- 确保每个依赖类型有且仅有一个导出的 provider 函数（如
NewDB()、NewCache()） - 如果多个函数返回相同基础类型（比如都返回
string），必须用类型别名拆开：type DBDSN string和type RedisAddr string，再让对应 provider 分别返回它们 -
wire.Build()里不要传入未导出函数（首字母小写），否则 wire gen 会静默忽略
wire.go 文件为什么必须加 // +build wireinject
这行不是注释，是 Go 的构建约束（build tag），告诉 wire 命令：“只在这个文件里找 injector 函数”。没有它，wire gen 就找不到你的 InitializeApp() 这类入口函数，直接报 no injectors found。
使用场景：一个项目可能有多个 wire.go（比如按模块拆分），每个都靠这个 tag 独立生效；CI 脚本里执行 wire gen 也依赖它精准定位。
立即学习“go语言免费学习笔记（深入）”；
- 必须放在文件顶部，且独占一行，前后不能有空行或其它内容
- 不能写成
// +build wireinject,linux这种多 tag 组合，wire 只认纯wireinject - 如果你用 IDE 自动格式化工具（如 gofumpt），注意它可能删掉这行——建议加到 .gofumpt 忽略列表
wire gen 生成的 wire_gen.go 能不能手动改
不能。所有修改都会在下次 wire gen 时被覆盖，而且生成文件开头明确写着 // Code generated by Wire. DO NOT EDIT.。
性能影响：生成的代码就是普通 Go 初始化逻辑，无反射、无 interface{}、无运行时查找，和你手写的一样高效；但一旦手动改了，就失去与 provider 定义的同步能力，后续新增依赖或改签名时，wire 不再能帮你校验一致性。
- 想加日志或中间逻辑？封装 provider 函数本身，比如把
NewDB()改成NewDBWithLog()，再放进wire.Build() - 想调试初始化顺序？看生成的
wire_gen.go里的调用链，它严格按依赖拓扑排序，比人脑更可靠 - CI 中建议加检查：
git diff --quiet || (echo "wire_gen.go out of date"; exit 1)
interface 注入失败的典型原因
Wire 默认按具体类型匹配 provider，不会自动把 *sql.DB 当作 driver.Connector 注入，也不会把 *PostService 自动转成 IPostService —— 它不做类型断言或转换。
常见错误现象：wire: injectors.go:20:4: no provider found for service.IPostService，但你明明写了 func NewPostService() *PostService。
- provider 必须返回接口类型本身，而不是实现它的结构体：
func NewPostService() service.IPostService，而非*PostService - 如果实现体需要额外参数（比如 config），provider 仍要返回接口：
func NewPostService(cfg Config) service.IPostService - 避免在 provider 里做类型转换（如
return (*PostService)(nil)），Wire 不识别这种 trick
log.Logger 作为参数传进每个 service，还是用全局 log 实例。这些决策 wire 不替你做，它只忠实地把你写的依赖图，翻译成可读、可 debug、零运行时成本的 Go 代码。 
