Wire 是编译期依赖注入工具，通过 wire.go 文件声明 injector 和 provider，要求 // +build wireinject 独占首行、与目标包同级、仅含 injector 函数/wire.Build/空导入；报错需按类型精确匹配、显式列出所有依赖环节、避免多 provider 冲突，并提交 wire_gen.go。
Wire 不是“用不用”的问题，而是你开始写第二个 service、第三个 repository、需要区分 dev/staging/prod 配置时，手动 NewXXX 链必然出错——它用编译错误提前拦住你，而不是等服务启动后 panic。
wire.go 文件为什么总不生效
不是 Wire 配置错了，是 Go 构建系统根本没看到它。关键就三点：
-
// +build wireinject必须独占第一行，前面不能有空行、空格或注释；写成//+build wireinject（少空格）或// +build wireinject,ignore（多逗号）都会静默跳过 - 文件必须和目标包同级：你要生成
cmd/myapp/InitializeApp()，wire.go就得放在cmd/myapp/目录下，不能丢在项目根目录或internal/di/ - 文件里只允许三样东西：
InitializeApp()这类 injector 函数、wire.Build()调用、_ "github.com/google/wire"空导入；混入import "fmt"或变量声明，wire build会直接跳过整个文件，不报错也不生成
no provider found for *sql.DB 这类报错怎么快速定位
Wire 不猜类型，只做精确匹配。报错里的类型名就是线索：
- 检查是否漏了
*：*sql.DB和sql.DB是两个完全不同的类型，不能互换 - 确认提供者函数签名是否严格一致：比如
NewDB(d *sql.DB) *Repository可以，但NewDB(d interface{}) *Repository不行；参数名无关紧要，类型和星号一个都不能错 - 第三方类型（如
redis.Client）必须自己写 provider 封装，Wire 不会自动 import 或构造；嵌套结构体字段也不会展开——type Config struct { DB *sql.DB }≠ 提供*sql.DB，得显式提取或改用函数参数传入
wire.Build() 漏传函数，为什么报错总在“下游”类型
Wire 只扫描 wire.Build() 显式列出的函数，不递归查找整个代码库。漏掉中间环节，错误就断在那一层：
Golang Samber Hot
下载
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
立即学习“go语言免费学习笔记（深入）”；
- 假设
InitializeApp → NewService → NewRepository → NewDB，但wire.Build(InitializeApp, NewService)没写NewRepository和NewDB - Wire 会尝试生成
NewService的调用，发现它需要*Repository，但列表里没有返回该类型的函数 → 报no provider found for *Repository - 它不会提示“你漏了
NewRepository”，也不会继续往下查“谁该提供*Repository”——所有环节必须显式列出
多个同类型 provider（比如两个 *sql.DB）怎么处理
Wire 要求类型唯一可推导，同返回类型多 provider 是硬性禁止。函数名对 Wire 完全无意义，它只认签名：
- 错误现象：
multiple providers found for *sql.DB - 不能靠
NewPrimaryDB()/NewReplicaDB()绕过 - 正确解法只有两种：
wire.Value(primaryDB)和wire.Value(replicaDB)绑定具体实例；或用wire.Struct(new(App), "primaryDB", "replicaDB")，并确保结构体字段名与绑定名一致 - 基础类型（如
string）也一样：必须用类型别名拆开，type DBDSN string和type RedisAddr string，再让对应 provider 分别返回
Wire 生成的 wire_gen.go 必须提交进 Git——它不是临时文件，而是你依赖图的“快照”。一旦忘记提交，CI 构建或新同事拉代码就会直接编译失败，且错误信息和本地开发时完全不同。
