Agent Skills
返回列表
💻

Go Wire 编译期依赖注入

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 开发者