Golang Google Wire （Google Wire 是一种用于 Golang 的依赖注入工具）

角色：您是一名使用wire进行编译时依赖注入的Go架构师。您让编译器捕获缺失的依赖项，将wire_gen.go视为提交的源代码，并在每次图形更改后重新运行wire ./...。使用google/wire进行Go代码的编译时依赖注入。Wire在编译时解析依赖图并发出纯Go构造函数调用——无运行时容器，无反射。错误出现在运行wire ./...时，而不是第一次请求时。注意：google/wire在2025年8月被归档（功能完整；仍然接受错误修复）。官方资源：pkg.go.dev · github.com/google/wire · 用户指南 · 最佳实践。本技能并不详尽。请参考库文档和代码示例以获取更多信息。Context7可以作为发现平台提供帮助。go install github.com/google/wire/cmd/wire@latest go get github.com/google/wire wire与运行时DI的比较：

func NewConfig() Config { return &Config{Addr: ":8080"} }
func NewDB(cfg Config) (sql.DB, error) { return sql.Open("postgres", cfg.DSN) }
func NewRedis(cfg Config) (redis.Client, func(), error) { 
    // cleanup链式调用以反向顺序
    c := redis.NewClient(&redis.Options{Addr: cfg.RedisAddr})
    return c, func() { c.Close() }, nil
}

// infra/wire.go
var InfraSet = wire.NewSet(
    NewConfig,
    NewDB,
    NewRedis,
)
// service/wire.go
var ServiceSet = wire.NewSet(
    NewUserRepo,
    NewUserService,
    wire.Bind(new(UserStore), new(UserRepo)), // 接口绑定
)

注入器： 注入器文件声明初始化函数。Wire生成其主体到wire_gen.go并替换stub。

//go:build wireinject
package main
import "github.com/google/wire"
// Wire生成此函数的主体。
func InitApp() (App, func(), error) {
    wire.Build(InfraSet, ServiceSet, NewApp)
    return nil, nil, nil // 由代码生成替换
}

func InitApp() (App, func(), error) {
    panic(wire.Build(InfraSet, ServiceSet, NewApp))
}

var Set = wire.NewSet(
    NewPostgresUserRepo,
    wire.Bind(new(UserStore), new(PostgresUserRepo)), // 告诉wire：PostgresUserRepo满足UserStore
)

wire.Struct(new(Server), "Logger", "DB") // 注入命名字段
wire.Struct(new(Server), "") // 注入所有非排除字段
wire.Value(Foo{X: 42}) // 常量表达式（无函数调用/通道）
wire.InterfaceValue(new(io.Reader), os.Stdin) // 接口类型字面量
wire.FieldsOf(new(Config), "DSN", "Addr") // 提升结构字段作为图节点

type PrimaryDSN string
type ReplicaDSN string

// wire.go —— 注入器，通过构建标签排除在二进制文件之外
//go:build wireinject
package main
func InitApp() (App, func(), error) {
    wire.Build(config.ConfigSet, infra.InfraSet, service.ServiceSet, NewApp)
    return nil, nil, nil
}
// main.go
func main() {
    app, cleanup, err := InitApp()
    if err != nil {
        log.Fatal(err)
    }
    defer cleanup()
    app.Run()
}