SuperAPI AI 工具集

golang-uber-dig

编程与开发

查看项目

更新于 10-16 08:44

技能介绍

用途:在 Go 项目中用 uber-go/dig 搭建依赖注入容器,在启动阶段解析对象图。dig 是基于反射的 DI 工具包,也是 uber-go/fx 的底层引擎。安装:go get go.uber.org/dig。

主要能力:用 dig.New() 创建容器;c.Provide 注册构造函数(惰性、按输出类型记忆化,每个容器内单例);c.Invoke 以函数参数形式取出依赖。构造函数输入为依赖、输出为提供的类型,最后一个 error 表示构造失败。依赖较多时用 dig.In 参数对象并按 name、optional、group 标签分组;用 dig.Out 结果对象一次返回多个带标签的值。同名类型冲突时用 dig.Name 区分;多个提供者汇入一个切片用值组,group:"routes,flatten" 可展平,组内顺序不保证。dig.As 可把具体类型暴露为一个或多个接口。容器选项包括 dig.DeferAcyclicVerification()、dig.RecoverFromPanics()、dig.DryRun(true)。

使用方式:容器放在组合根(main),不要把它作为参数传给服务;依赖接口而非具体类型;构造函数返回 error 而非 panic;每个 Provide 用 must 辅助函数检查错误;在测试中用 Invoke 驱动组合根以尽早暴露缺失的提供者。

适用场景与限制:适合 CLI 工具、对外暴露容器的库、测试脚手架,或嵌入已有生命周期的应用。dig 本身不含生命周期钩子、模块系统、信号处理与结构化事件日志,这些由 fx 提供;需要 OnStart/OnStop、优雅关闭时选 fx。值组无序,顺序敏感时改由单个构造函数提供有序切片。更多 Decorate、Scopes、Visualize 等内容见其 advanced.md、recipes.md、testing.md,资料未提供具体细节。