SuperAPI AI 工具集

golang-google-wire

编程与开发

查看项目

更新于 10-16 09:55

技能介绍

用途:这是一个面向 Go 架构师的技能,讲解如何用 google/wire 做编译期依赖注入(DI)。wire 在编译期解析依赖图并生成普通 Go 构造函数调用,不需要运行时容器,也不使用反射,错误在运行 wire ./... 时暴露,而非首次请求时。资料注明 google/wire 已于 2025 年 8 月归档(功能完备,仍接受缺陷修复)。

安装:wire: go install github.com/google/wire/cmd/wire@latest;go get -tool github.com/google/wire/cmd/wire@latest;go get github.com/google/wire。

主要能力:provider 是任意 Go 函数,入参为依赖、出参为提供的类型,支持 (T)、(T, error)、(T, func(), error) 三种返回形式,清理函数按逆序串联。wire.NewSet 把 provider 分组复用,可引用其他 set;注入器文件用 //go:build wireinject 声明初始化函数,wire.Build 声明图,生成体写入 wire_gen.go。接口必须显式绑定:wire.Bind(new(UserStore), new(UserRepo))。还支持 wire.Struct(用 wire:"-" 排除字段、"" 注入全部未排除字段)、wire.Value、wire.InterfaceValue、wire.FieldsOf。

用法:改完构造函数签名后运行 wire ./... 重新生成;wire check ./... 可在不重新生成时校验图,适合快速 CI;可添加 //go:generate go run github.com/google/wire/cmd/wire 让 go generate ./... 生效;提交 wire_gen.go 并保持同步。同名类型冲突用命名类型区分,如 type PrimaryDSN string。

限制与注意:wire_gen.go 每次运行都会被覆盖,不要手改;注入器文件必须加 //go:build wireinject,否则与生成文件重复定义函数导致编译错误;同一类型只能有一个 provider;接口不声明 wire.Bind 会被禁止;构造失败时 cleanup 可能为 nil,需判空;归档状态下无新功能。测试方面,生成的是普通构造函数,单测可用手动注入;测试注入器、伪实现替换、CI 陈旧检查等详见其 testing.md。具体功能、收费与平台信息暂未提供。