Wire不生成运行时注入逻辑，只编译前生成硬编码NewXXX调用链；未执行wire build则InitializeApp等函数不存在，编译直接失败；wire.go首行必须为// +build wireinject（无空格、无逗号）、与目标包同级、仅含injector函数和wire.Build()调用；漏传provider导致报错指向缺失类型而非源头；同返回类型多provider需用wire.Value或wire.Struct区分；wire_gen.go必须提交Git，否则CI编译失败。
Wire 不生成运行时注入逻辑，它只在编译前生成硬编码的 NewXXX 调用链；没跑 wire build，InitializeApp 这类函数根本不存在，编译直接失败。
为什么 wire.go 必须带 // +build wireinject
这不是注释，是 Go 构建约束（build tag）。没有它，go build 和 wire build 都会跳过该文件，导致静默无输出或报 no injector found。
-
// +build wireinject必须独占第一行，前面不能有空格，不能加逗号或额外单词（比如// +build wireinject,ignore无效） - 文件必须和目标包同级：你要生成
cmd/myapp/InitializeApp()，wire.go就得放在cmd/myapp/目录下 - 文件里只允许：
injector函数（如InitializeApp()）、wire.Build()调用、以及_ "github.com/google/wire"的空导入 - 混入
import "fmt"或变量声明，wire会直接忽略整个文件
wire.Build() 漏传函数，为什么报错总在“最后一环”
Wire 不递归扫描项目，它只信任 wire.Build() 显式列出的函数。漏掉中间 provider，生成链就断在那一层，而 Go 编译器报错永远指向“谁调用了缺失类型”，不是“你漏了谁”。
- 例如：
InitializeApp → NewService → NewRepository → NewDB，但wire.Build(InitializeApp, NewService)没写NewRepository和NewDB - Wire 会尝试生成
NewService的调用，发现它需要*Repository，但列表里没有返回*Repository的函数 → 报no provider found for *Repository - 它不会提示“你漏了
NewRepository”，也不会继续往下查“谁该提供*Repository” - 所有环节必须显式列出：
wire.Build(InitializeApp, NewService, NewRepository, NewDB)
两个 provider 都返回 *sql.DB，Wire 直接报错怎么办
Wire 要求类型唯一可推导。同返回类型多 provider 是硬性禁止——函数名对 Wire 完全无意义，它只认签名。
立即学习“go语言免费学习笔记（深入）”；
- 错误现象：
multiple providers found for *sql.DB - 不能靠
NewPrimaryDB()/NewReplicaDB()绕过 - 正确解法只有两种：
– 用wire.Value绑定具体实例：wire.Value(primaryDB)和wire.Value(replicaDB)
– 用wire.Struct按字段注入：wire.Struct(new(App), "primaryDB", "replicaDB")，并确保结构体字段名与绑定意图一致（如PrimaryDB *sql.DB）
生成的 wire_gen.go 为什么必须提交到 Git
wire_gen.go 是构建产物，但不是临时缓存——它是编译链的硬依赖。CI 拉代码后若缺失，go build 直接失败，且报错指向未定义的 InitializeApp，而非“wire_gen.go 缺失”。
- 常见错误：
.gitignore写了**/*.go或inject*，导致文件没进仓库 - CI 流程中必须前置执行
wire build，或加检查：git diff --quiet || (echo "wire_gen.go out of date"; exit 1) - 文件开头明确写着
// Code generated by Wire. DO NOT EDIT.，手动改等于自毁一致性
最常被忽略的是构建约束的格式细节和 wire_gen.go 的提交义务——它们不报错，但会让整个工作流在 CI 或新成员本地彻底失效。
