Go 依赖注入实践
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/samber-cc-skills-golang-golang-dependency-injection。
技能介绍
问题背景
Go 服务里若用 全局变量、init() 偷偷拼装依赖,或把 container 当参数到处传(service locator),单元测试很难替换实现,模块边界也会糊成一团。依赖注入的本质是:组件只声明需要什么,由调用方或容器在构造时提供——这和「accept interfaces, return structs」是一套的。
技能如何帮你做决策与落地
技能以 Go 软件架构师 人设工作,强调选最简单够用的 DI 方案,不过度工程化。
- Design mode:新建服务或已有 DI 体系里加模块时,先看清依赖图与生命周期,再按决策表选手工构造函数注入或库(如
google/wire、uber-go/fx、uber-go/dig、samber/do),并生成 wiring 代码。 - Refactor mode:面向已耦合的大代码库,可并行三条线:全局变量 /
init()服务初始化、应对接口化的具体类型依赖、service locator 反模式定位;汇总后给出迁移计划。在 Claude Code 上可用 ultracode 显式启用多 agent 编排。 - 测试:强调用 mock 替换真实实现;集成测试场景下可结合
samber/do的 Clone / Override,在保留大部分真实服务的同时只 mock 边界(DB、外部 API、邮件等)。
边界与注意点
本技能不是各 DI 库的完整 API 手册——使用 wire、dig、fx、samber/do 时仍以官方文档为准。接口设计与组合基础见关联的 structs/interfaces 技能;何时该上 DI 库、何时该 Flatten 过深依赖链、何时避免「每个请求一个新 container」等,技能里有对照表可参考。若组织内有覆盖 samber/cc-skills-golang 同主题的自定义技能,以其为准。
使用场景
- 新微服务要从零设计 UserService→Repository 构造函数注入与启动装配
- 遗留项目大量 package 级 DB 客户端,需要梳理 init 并改成可 mock 的接口注入
- 团队要在 wire、fx、samber/do 之间选型并写出符合项目规模的 wiring 样板
- 集成测试要保留真实业务服务,仅 mock 数据库或第三方支付网关
适合人员
- 维护单体 Go 后端、要把全局单例拆成可测构造注入的中高级工程师
- 负责新服务脚手架与启动流程、需统一 DI 初始化位置的 Tech Lead
- 写集成测试频繁、希望用容器 Clone 只覆盖边界依赖的测试工程师
- 正在从 service locator(到处传 container)迁移到显式依赖图的架构评审者