SuperAPI AI 工具集

golang-samber-do

编程与开发

查看项目

更新于 10-16 09:55

技能介绍

用途:在 Go 项目中用 samber/do v2 做类型安全依赖注入,把服务注册与解析集中到组合根,依赖接口而非具体类型。请安装 v2:

go get -u github.com/samber/do/v2

主要能力:容器用 do.New() 创建;服务经 Provider 函数注册,类型为 func(i Injector) (T, error)。服务分四类:Lazy(默认,首次请求时创建)、Eager(容器启动时创建)、Transient(每次请求新建实例)、Value(预创建值)。支持命名服务(ProvideNamed)与隐式别名(注册具体类型后以接口 do.MustInvokeAs[Database] 解析)。do.Package() 可按模块聚合注册,main 里 do.New(infrastructure.Package, service.Package) 组合。容器支持优雅关闭,如 injector.ShutdownOnSignalsWithContext(context.Background(), os.Interrupt)。

用法要点:解析用 do.Invoke[T](返回错误)或 do.MustInvoke[T](出错 panic);在 Provider 内部推荐 MustInvoke 系列,库会在外层 Invoke 调用处捕获并恢复 panic,转回普通错误,避免每个 Provider 重复 if err != nil。注册具体类型后可用 MustInvokeAs 按接口取用。

适用场景:中大型 Go 应用按基础设施、仓储、服务、传输分层组织依赖;需要请求级作用域、生命周期管理与健康检查、优雅退出的服务。

限制:本资料未提供收费、价格与具体性能数据;作用域、生命周期、结构体注入、调试及测试(克隆、覆盖、Mock)细节未在本资料展开,属暂未提供,需查阅官方文档 pkg.go.dev/github.com/samber/do/v2 与 do.samber.dev。