Wire是编译期依赖注入工具，通过生成纯Go代码实现声明式构造逻辑和编译时依赖校验。它不引入runtime开销，不管理生命周期，仅拼接由开发者编写的Provider函数调用链。
Wire 是什么，为什么不用手写 NewXXX 函数
Wire 不是运行时反射容器，它在编译前就生成纯 Go 代码，不引入任何 runtime 依赖，也不影响二进制体积和启动速度。你手写 NewService、NewRepository 嵌套调用没问题，但一旦模块变多、构造逻辑带条件分支（比如测试环境用 mock）、或者要支持多种配置组合（dev/staging/prod），手动维护就会开始漏参数、错顺序、忘 cleanup，而且没法静态检查依赖闭环。
Wire 的核心价值就两点：把构造逻辑声明化，让编译器帮你校验依赖图是否可解。它不接管对象生命周期，也不做单例管理——所有实例化逻辑仍是你写的函数，Wire 只负责按需拼接调用链。
怎么写 wire.go 并触发代码生成
Wire 要求你在每个需要注入的包里放一个 wire.go 文件（名字固定），里面只保留构建器声明和 wire.Build 调用，且必须用 //+build wireinject 标记，避免被常规构建加载。
常见错误现象：go run github.com/google/wire/cmd/wire 报 “no main found” 或 “could not find provider for *xxx.Service”，通常是因为：
立即学习“go语言免费学习笔记（深入）”；
-
wire.go没加//+build wireinject注释，导致文件被忽略 - 提供者函数（比如
ProvideDB）没在同一包内，或签名不匹配（返回值类型与依赖需求不一致） - 依赖链中某个类型没有提供者，且不是基础类型（
string、int等）或已由标准库提供（如*log.Logger）
示例（app/wire.go）：
//+build wireinject
package app
func InitializeApp() (*Application, error) {
wire.Build(
NewApplication,
NewService,
NewRepository,
ProvideDB,
)
return nil, nil
}
Provider 函数怎么写才不被 Wire 拒绝
Wire 只认函数签名：输入是它能“凑出来”的依赖，输出是你声明要提供的类型。它不看函数体，但对参数和返回值极其严格。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
容易踩的坑：
- 参数名无关紧要，但类型必须精确匹配（
*sql.DB≠database/sql.DB） - 不能返回指针以外的接口实现（比如
io.Reader必须由具体类型返回，不能靠类型别名“伪装”） - 如果提供的是 interface，必须确保该 interface 在整个依赖图中只被一个 concrete type 实现，否则报 “multiple providers”
- 带 error 返回的 provider（如
func() (*sql.DB, error)）会被 Wire 自动处理，失败时整个初始化中断
示例（infra/db.go）：
func ProvideDB(dsn string) (*sql.DB, error) {
db, err := sql.Open("postgres", dsn)
if err != nil {
return nil, err
}
return db, nil
}
注意：dsn 是字符串，所以你得在 wire.go 中显式传入，或用 wire.Value 注入常量。
如何处理环境差异和可选依赖
Wire 本身不支持“if config.TestMode { use MockX }”，它要求所有路径在编译期确定。所以真实项目里，你要靠 Go 的 build tag 或多文件组织来切分支。
典型做法：
- 为不同环境建子包：
infra/db_prod和infra/db_mock，各自提供同名函数（如ProvideDB），再用//go:build prod控制启用 - 用
wire.NewSet抽离可替换模块，比如DatabaseSet = wire.NewSet(ProvideDB, ProvideMigrator)，然后在主wire.Build中按需引用 - 对真正可选的依赖（比如 metrics reporter 可有可无），不要让它成为构造函数的必填参数；改用 setter 方法或后期注册（
app.RegisterReporter(r)）
别试图用 wire.Bind 绑定 interface 到多个实现——它只允许一次绑定。想换实现？换 provider 函数，而不是在同一个 wire graph 里塞 if-else。
复杂点在于：Wire 的依赖图是扁平且静态的，所有分支都得提前枚举清楚。一旦你开始写 if 判断配置字段来决定 new 哪个 struct，说明已经不适合用 Wire，该退回到手写工厂或引入更动态的方案了。
