wire不是运行时反射注入，而是在go build前通过代码生成完成依赖图分析和构造函数拼接；它不执行反射、不解析运行时类型，所有依赖必须静态可推导，缺失provider会在wire build阶段直接报错，而非启动时panic。
Wire 为什么不是运行时反射注入
Wire 不会在运行时解析类型或调用反射，它在 go build 前通过代码生成完成依赖图分析和构造函数拼接。这意味着：你写的每个 inject 函数必须能被静态推导出完整调用链；一旦某个依赖缺少提供者（provider），wire build 就会直接报错，而不是等到启动时 panic。
常见错误现象：wire: field injection not supported —— 这通常是因为你在 struct 字段上用了 inject 标签（Wire 不支持字段注入）；或者 wire: no provider found for *sql.DB —— 表示你没定义返回 *sql.DB 的函数，也没用 wire.Bind 显式绑定接口与实现。
- 所有 provider 必须是普通函数，不能是方法、闭包或匿名函数
- provider 函数参数只能是其他 provider 输出类型或已知的“输入”（如
string、config.Config等） - 避免在 provider 中做副作用操作（如连接 DB、启动 goroutine），Wire 只负责构造，不控制生命周期
如何写一个可被 Wire 识别的 injector 函数
Wire 的入口是标记为 //+build wireinject 的 Go 文件里的 injectXXX 函数（名字任意，但必须带 inject 前缀）。这个函数只用于描述“我要什么”，不执行逻辑。
例如，你要启动一个 HTTP server，依赖 *gin.Engine 和 *redis.Client：
//+build wireinject
package main
import (
"github.com/go-redis/redis/v8"
"github.com/gin-gonic/gin"
"google.golang.org/wire"
)
func injectApp() (*App, error) {
wire.Build(
newApp,
newGinEngine,
newRedisClient,
wire.Struct(newHTTPServer, "*"),
)
return &App{}, nil
}
注意：wire.Struct 是必需的——因为 newHTTPServer 接收的是指针参数，而 Wire 默认只自动匹配值类型参数；"*" 表示把所有字段按类型注入（前提是字段类型已在 provider 链中可解）。
- 不要在
injectApp里调用任何实际初始化逻辑，它只是 Wire 的 DSL - 如果
newGinEngine返回*gin.Engine，但你的App字段是engine *gin.Engine，Wire 能自动匹配；但如果字段名是e *gin.Engine，就无法匹配，必须用wire.FieldsOf或显式构造 - 多个同类型 provider（比如两个
*sql.DB）必须用wire.NewSet+wire.As区分，否则 Wire 会报歧义
Wire 生成代码后怎么维护和调试
运行 wire generate 后，会在当前目录生成 wire_gen.go。这个文件不应手动修改，也不应加 git ignore —— 它是构建链的一部分，CI 会重新生成并校验一致性。
调试依赖问题最有效的方式是看生成的 wire_gen.go：它会把整个构造链展开成普通 Go 代码，比如 newApp 里怎么一步步 new 出 redis.Client、再传给 HTTPServer。如果某步出错，生成代码里会直接 panic 并带行号，比原始错误信息更准。
- 生成失败时优先检查
wire_gen.go是否残留旧逻辑（比如删了 provider 但没删生成文件），建议每次改完 provider 后rm wire_gen.go && wire generate - 如果生成代码里出现
nil传参，说明某个 provider 返回了零值（比如newRedisClient没处理连接失败，直接 return nil），Wire 不校验返回值有效性，这要靠单元测试覆盖 - Wire 不处理循环依赖，报错信息是
wire: cycle detected，此时需引入中间 interface 或拆分 provider 层级
Wire 和 Uber-Fx、GoDI 等运行时 DI 的关键区别
Wire 的生成代码本质就是手写工厂函数的自动化版本，没有额外 runtime 开销，也没有容器注册表、作用域（singleton/transient）等概念。它不提供“单例复用”保障——如果你在两个 provider 里都调用了 sql.Open，Wire 就真会开两次连接。
所以实际使用中必须主动控制复用：要么让 provider 返回指针并复用同一实例（如 func newDB(...) (*sql.DB, error) 只执行一次），要么用 wire.Value 注入已存在的实例（适合配置、logger 等全局对象）。
-
wire.Value和wire.InterfaceValue是少数允许注入“非函数构造”的方式，但要注意它们绕过类型安全检查，慎用 - 没有内置 health check、lifecycle hook（start/stop），这些得自己在生成后的
App上补全 -
微服务多模块时，推荐每个 service 包单独建
wire.go，用wire.NewSet导出 provider 集合，主模块组合调用，避免 provider 泄漏到无关包
Wire 的边界很清晰：它只解决“谁创建谁、谁传给谁”，不碰“什么时候创建”“创建几次”“怎么销毁”。这些责任仍由开发者用结构体字段、init 函数或外部 lifecycle manager 承担。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
