Go Wire 编译期依赖注入
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/samber-cc-skills-golang-golang-google-wire。
技能介绍
要解决的痛点
在 Go 里手工拼 NewFoo(db, cache, logger) 很容易漏传依赖,或者同一底层类型(两个 *sql.DB)在图里没法区分。反射式 DI(dig、fx、samber/do)往往把错误推迟到首次启动或第一次 Invoke,排查成本高。
技能如何引导你使用 Wire
本技能按 Google Wire 的代码生成流程组织:用 Provider(普通 Go 函数)声明依赖,wire.NewSet 组成可复用的 Provider Set;在带 //go:build wireinject 的 Injector 里调用 wire.Build,由 wire ./... 生成 wire_gen.go——本质是纯 Go 构造函数调用,没有运行时容器。
关键约束与步骤包括:接口实现必须用 wire.Bind 显式绑定;同一类型只能有一个 provider,重复类型用具名类型(如 type PrimaryDB struct { *sql.DB })区分;清理逻辑用 (T, func(), error) 返回值让 Wire 生成逆序 cleanup;依赖图变更后必须重新跑 wire ./...,且把 wire_gen.go 当作已提交的生成物,不要手改。
适用边界与注意点
Wire 不内置 fx 那种 OnStart/OnStop 生命周期;懒加载、完整对比矩阵见交叉技能 golang-dependency-injection。官方仓库已于 2025 年 8 月归档(功能完备,仍接受缺陷修复),适合已选定 Wire、或希望编译期就把依赖图钉死的团队。单元测试走手动注入,可用 test injector 换 fake provider;CI 可检查 wire_gen.go 是否与 provider/injector 同步。
使用场景
- 新项目要按包拆分 provider set,并在 CI 里用 wire ./... 生成并校验 wire_gen.go
- 同一进程要注入主库与只读库两个 *sql.DB,需用具名类型与独立 provider 避免 Wire 报重复类型
- HTTP 服务启动前要串联 DB、缓存、logger 的 cleanup,希望 Wire 自动生成逆序 teardown 链
- 重构构造函数签名后,需要在 go generate 或 Makefile 里固定重跑 wire,避免二进制与图不同步
适合人员
- 维护中大型 Go 单体或微服务、希望依赖缺失在 codegen 阶段暴露的后端工程师
- 正在从 dig/fx 迁移或对比方案、需要编译期 DI 与 wire.Bind 命名类型实践的架构师
- 负责 CI 流水线、要把 wire_gen.go 同步检查纳入合并门禁的 DevOps / 平台同学
- 编写集成测试并需用 test injector 替换真实 provider 的 Go 开发者