wire 不能直接替换 new() 或构造函数，因其在编译前生成硬编码初始化逻辑，仅解决静态依赖链路，不支持动态绑定、条件实例化或运行时配置切换。
Wire 为什么不能直接替换 new() 或构造函数
Wire 不是运行时依赖注入框架，它在编译前就生成硬编码的初始化逻辑，所以你没法用它做动态绑定、条件实例化或运行时配置切换。它只解决“谁来创建对象”和“参数从哪来”的静态链路问题。
常见错误现象：panic: interface conversion: Interface {} is nil, not *MyService，往往是因为某依赖没被 Wire 正确提供，而你又没检查 Build 返回的 Error —— Wire 的 Inject 函数不 panic，但返回值可能为 nil。
- 所有 provider 函数必须是公开的（首字母大写），否则 Wire 扫不到
- provider 函数不能有未导出参数（比如
func NewX(db *sql.DB, cfg privateConfig)会失败） - Wire 不处理循环依赖，报错信息是
cycle detected，但不会指出具体哪几个类型卡住了，得自己顺藤摸瓜
如何写一个能被 Wire 识别的 Provider 函数
Provider 就是普通 go 函数，但签名要干净：输入是依赖项，输出是你想构造的类型 + 可选 error。Wire 通过类型匹配自动连线，不看函数名。
使用场景：比如初始化数据库连接、http 客户端、gRPC server 等需要传参或可能失败的组件。
立即学习“go语言免费学习笔记（深入）”；
参数差异：如果两个 provider 都返回 *sql.DB，Wire 会报错 multiple bindings for *sql.DB。必须用 interface{} 包装或定义新类型（如 type PrimaryDB *sql.DB）来区分。
示例：
func NewDB(dsn String) (*sql.DB, error) { db, err := sql.Open("postgres", dsn) if err != nil { return nil, err } return db, nil }- 返回值必须是你要提供的类型（
*sql.DB），不能是interface{}或别名类型，除非你显式绑定 - 参数类型必须能被其他 provider 满足，或者来自
Wire的String、Int等内置 provider - 不要在 provider 里做 heavy init（比如 migrate），Wire 生成的代码会每次调用都执行——应该拆成
NewDB+ 单独的MigrateDB调用
wire.go 文件里 Build 函数总报错：no main provider found
这是 Wire 找不到入口点。它需要一个函数，返回你要最终拿到的对象（比如 *App），且这个函数的所有依赖都能被 chain 到 provider。
常见错误现象：no main provider found for *main.App，即使你写了 func InitializeApp(...) *App，但函数名不是 InitializeApp，或者没加 //+build wireinject 标签。
- 必须在
wire.go文件顶部加//+build wireinject，否则wire命令不扫描 -
Build函数必须返回你要的顶层类型，比如func InitializeApp(...) *App，且函数体里只写wire.Build(...) -
wire.Build参数只能是 provider 函数、wire.Value、wire.Struct等，不能是变量或表达式
Wire 生成的代码太长，怎么避免污染 git history
Wire 生成的 wire_gen.go 是纯机器码，不该手动改，也不该出现在 code review 里。但它容易因格式、换行或注释微小变化导致大量 diff。
性能影响：生成代码本身零 runtime 开销，但每次 wire 运行都要解析整个 module，大型项目可能耗时 1–3 秒。
- 把
wire_gen.go加进.gitignore是错的——它必须提交，否则 CI 编译失败 - 统一团队的
gofmt和goimports版本，Wire 生成后立即格式化，可大幅减少无意义 diff - 不要把
wire.go放在main包以外的包里，否则wire可能找不到依赖的 provider（跨包扫描有限制）
最容易被忽略的是：Wire 不校验 provider 是否真被用到。一个没人引用的 func NewUnused() *X 会安静地留在代码里，直到某天你删掉它，才发现某个路径断了——得靠测试覆盖或定期 wire -check 配合 go list 手动排查。