Agent Skills
返回列表
💻

Go 依赖注入实践

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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)迁移到显式依赖图的架构评审者