wire是编译期代码生成工具，非运行时框架；wire.go首行必须为// +build wireinject，与目标包同级，仅含injector函数、wire.build()调用及空导入，漏参数或类型冲突导致生成失败而非运行时错误。
Wire 不是“配置框架”，它根本不运行，也不读配置文件；你写的 wire.Build 是编译前的构造指令，漏一个函数、错一行构建约束，InitializeApp 就不会生成，编译直接失败。
为什么 wire.go 第一行必须是 // +build wireinject
这不是注释，是 Go 构建系统的开关标记。没有它，go build 和 wire build 都会跳过这个文件，导致静默无输出——既不报错，也不生成 wire_gen.go，最终编译时提示 undefined: InitializeApp。
-
// +build wireinject必须独占第一行，前面不能有空格，不能加逗号或额外单词（比如// +build wireinject,ignore无效） - 该文件必须和目标包同级：你要生成
cmd/myapp/InitializeApp()，wire.go就得放在cmd/myapp/目录下，不能丢在项目根目录或internal/ - 文件里只允许有 injector 函数（如
func InitializeApp() *App）、wire.Build()调用、以及_ "github.com/google/wire"的空导入；混入import "fmt"或变量声明，wire会直接忽略整个文件
wire.Build() 漏传 provider 为什么总报“最后一环”错误
Wire 不递归扫描代码库，它只信任 wire.Build() 显式列出的函数。漏掉中间 provider，生成链就断在那一层，而 Go 编译器报错永远指向“谁调用了缺失类型”，而不是“你漏了谁”。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 假设
InitializeApp → NewService → NewRepository → NewDB，但wire.Build(InitializeApp, NewService)里没写NewRepository和NewDB - Wire 会尝试生成
NewService的调用，发现它需要*Repository，但列表里没有返回*Repository的函数 → 报no provider found for *Repository - 它不会继续往下查“谁该提供
*Repository”，更不会提示“你漏了NewRepository”——这是静态分析的边界 - 所有环节必须显式列出：
wire.Build(InitializeApp, NewService, NewRepository, NewDB)
两个函数都返回 *sql.DB，wire 直接报错怎么办
Wire 要求类型唯一可推导。同返回类型多 provider 是硬性禁止，它不看参数名或函数名，只认签名。
- 错误现象：
multiple providers found for *sql.DB - 不能靠
NewPrimaryDB()/NewReplicaDB()绕过，函数名对 Wire 完全无意义 - 正确解法只有两种：
– 用wire.Value绑定具体实例：wire.Value(primaryDB)和wire.Value(replicaDB)
– 用wire.Struct按字段注入：wire.Struct(new(App), "primaryDB")，前提是结构体字段名明确且小写字段默认被忽略（需显式指定或加 tag）
生成的 wire_gen.go 为什么必须提交到 Git
wire_gen.go 不是缓存，而是构建链的硬依赖。CI 拉代码后若缺失，go build 直接失败；本地没跑 wire build，新成员 go run main.go 也会报 undefined。
- 它由
wire build命令生成，内容是纯 Go 初始化代码（如db := NewDB(); cache := NewCache()），无反射、无接口断言 - CI 流程中必须前置执行
wire build，否则生成文件缺失，编译中断 - 大型项目中
wire_gen.godiff 大、难以 Code Review，建议按模块拆分wire.go文件并收敛wire.NewSet，避免单个文件爆炸
最常被忽略的是 provider 函数副作用：比如在 NewDB() 里调 db.Ping() 或启 goroutine。Wire 不检查函数体，只拼调用链——这些 panic 只会在运行时爆发，且无法被编译期捕获。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
