Wire 是编译期依赖注入工具，仅在 go build 前生成纯 Go 初始化代码，要求显式构造函数、清晰接口抽象与规范类型命名，否则直接报错退出。
Wire 不是运行时容器，它只在 go build 前生成纯 Go 初始化代码；如果你的项目没有显式构造函数、接口抽象不清晰、类型命名混乱，Wire 会直接报错退出，而不是“帮你绕过去”。
wire.go 文件必须带 //+build wireinject 且不能混业务逻辑
这是 Wire 找不到 injector 的最常见原因。文件第一行必须是 //+build wireinject（注意：前面不能有空格，不能写成 // +build wireinject 或加逗号），且该文件只能包含：
- 一个 injector 函数（如
func InitializeApp() *App），必须导出、无参数、返回你要构建的顶层类型 - 一个
wire.Build(...)调用，列出所有 provider 和 set - provider 函数声明（如
func NewDB(...) *sql.DB），但不能有实际业务代码或测试逻辑
验证方式：运行 go build -tags wireinject ./cmd/myapp，如果报 no main found 或找不到 injector，基本就是构建约束失效或文件位置不对。
wire.Build() 必须显式包含所有中间依赖
Wire 不扫描全局，只认 wire.Build() 参数列表里明写的函数或 set。漏一个 provider，生成的 wire_gen.go 就会编译失败，错误指向未定义的符号，比如：
-
undefined: NewRepository→ 你用了*Repository，但没把NewRepository加进wire.Build() -
cannot use db (type *sql.DB) as type *db.Pool→ 类型不匹配，sql.DB和db.Pool是完全不同的类型，Wire 不做别名推导 -
multiple providers found for *redis.Client→ 两个 provider 都返回*redis.Client，Wire 拒绝歧义，得用wire.Value或拆成不同语义类型（如type CacheClient *redis.Client）
基础类型（string、int）必须封装为具名类型才能注入
Wire 默认禁止裸基础类型注入，因为它们无法区分语义。比如你不能让两个模块都依赖 string，然后指望 Wire 知道哪个是 DB 地址、哪个是 HTTP 端口。
- 正确做法：定义
type HTTPAddr string、type MySQLConnString string，provider 返回这个新类型，injector 参数也声明为该类型 - 避免用
wire.Value("localhost:8080")—— 它只适用于极少数常量（如wire.Value(math.Pi)），且无法参与依赖推导 - 更推荐：把配置聚合成结构体，用
wire.Struct(new(Config), "*")，字段名和类型一一对应，安全又清晰
大型项目必须用 wire.NewSet 分组，禁止全堆在一个 wire.Build() 里
把所有 ProvideXxx 和 NewXxx 全塞进一个 wire.Build() 是失控起点。你应该按能力域切分：
- 每个子模块导出自己的 set：如
auth.Set、cache.RedisSet、storage.S3Set - 顶层
wire.go只组合这些 set：wire.Build(auth.Set, cache.RedisSet, storage.S3Set) - 测试时替换 set：
wire.Build(auth.Set, test.MockCacheSet, storage.InMemorySet)，不污染主流程 - 注意：set 之间不能循环引用；跨包 set 的完整性由你负责，Wire 只校验最终 injector 所需类型是否可解
真正难的不是写对第一个 wire.Build()，而是当项目长到 20+ 个模块、50+ 个 provider 时，还能让 wire_gen.go 的 diff 可读、生成速度可控、错误定位明确——这取决于你从第一天起就约束类型命名、收敛依赖入口、拒绝裸基础类型。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
