Wire是编译期代码生成工具，InitializeApp等函数仅在执行wire build后生成并需提交wire_gen.go至Git；常见失败原因包括wire.go首行缺失// +build wireinject、文件位置错误、混入业务逻辑或wire.Build()漏传依赖。
Wire 不生成运行时注入逻辑，InitializeApp 这类函数根本不存在，除非你显式执行 wire build 生成 wire_gen.go 并提交到 Git —— 否则编译直接失败。
为什么 wire build 没反应或报 no injector found
核心问题几乎总是构建约束没生效。Go 构建系统会跳过不满足 // +build 条件的文件，而 Wire 完全依赖它来定位入口。
-
wire.go第一行必须是// +build wireinject（前面不能有空格，不能写成// +build wireinject,ignore或加其他注释） - 该文件必须和目标包同级：比如你要生成
cmd/myapp/InitializeApp()，wire.go就得放在cmd/myapp/目录下，不能丢在项目根目录或internal/里 - 文件里只能有 injector 函数（如
func InitializeApp() *App）和wire.Build()调用；混入import、变量声明或业务逻辑，Wire 就会静默忽略 - 确保
go list -f '{{.Name}}' ./...能列出这个包 —— 如果包路径被go.mod排除或未被识别，Wire 根本扫不到
wire.Build() 里漏传函数，为什么报错指向“找不到 NewRepository”而不是“你漏了 NewDB”
Wire 不递归扫描整个代码库，它只信任 wire.Build() 显式列出的函数。漏掉中间 provider，会导致生成的初始化链断在某一层，而 Go 编译器报错位置永远是“最终调用点”，不是缺失源头。
- 假设
InitializeApp→NewService→NewRepository→NewDB，但你只写了wire.Build(InitializeApp, NewService) - Wire 会尝试生成
NewService的调用，发现它需要*Repository，但列表里没有提供*Repository的函数，于是报no provider found for *Repository - 它不会继续往下查“谁该提供
*Repository”，更不会提示“你漏了NewRepository”——这是静态分析的边界 - 所有环节必须显式列出：
wire.Build(InitializeApp, NewService, NewRepository, NewDB)
两个函数都返回 *sql.DB，Wire 直接报错怎么办
Wire 要求类型唯一可推导。同类型多 provider 是明确禁止的，它不支持“按名称区分”，只认签名。
立即学习“go语言免费学习笔记（深入）”；
- 错误现象：
multiple providers found for *sql.DB - 不能靠参数名（如
NewPrimaryDB()vsNewReplicaDB()）绕过，Wire 只看返回类型 - 正确解法只有两种：
– 用wire.Value绑定具体实例：wire.Value(primaryDB)和wire.Value(replicaDB)
– 用wire.Struct按字段注入：wire.Struct(new(App), "primaryDB", "replicaDB")，前提是App结构体字段名和类型严格匹配 - 别试图用别名类型（如
type PrimaryDB *sql.DB）欺骗 Wire —— 它不识别未导出别名，且生成代码无法通过编译
生成的 wire_gen.go 为什么必须提交到 Git
这不是缓存文件，而是构建链的硬依赖。CI、新同事、甚至你重启 IDE 后的第一次 go run，全都依赖它存在且内容准确。
- 文件开头有固定注释：
// Code generated by Wire. DO NOT EDIT.—— 手动修改等于破坏生成契约 -
.gitignore里如果写了**/*.go或wire_*.go，会导致文件被过滤，新人拉代码后立即undefined: InitializeApp - CI 流程中必须包含
wire build步骤，且建议加校验：git diff --quiet || (echo "wire_gen.go out of date"; exit 1) - 最隐蔽的坑：本地改了
wire.go但忘了跑wire build，Git 状态显示 clean，实际部署时 panic —— 因为旧的wire_gen.go仍在用
