Golang wire如何做依赖注入_Golang wire教程【详解】-Golang-PHP中文网

wire 是编译前代码生成器，通过 wire build 生成 inject.go 中的手动初始化代码，不参与运行时注入；provider 函数需满足签名可推导、无副作用，inject.go 必须提交至 git 且 ci 中需前置执行 wire build。

golang wire如何做依赖注入_golang wire教程【详解】

Wire 不是运行时 DI 框架，它根本不会“自动注入”——它在编译前生成 inject.go 文件，把依赖组装逻辑写成普通 Go 代码。你看到的 NewHandler、NewApp 都是生成出来的函数，不是 magic。

Wire 是代码生成器，不是运行时库。它不拦截 go run，也不参与 go build 默认流程。你必须显式运行 wire build（在含 wire.go 的目录下），它才会扫描 wire.Build() 调用、分析函数签名、生成 inject.go。

wire.go 必须带 // +build wireinject 标签，否则 go build 会直接忽略它
wire build 成功后，会输出一个 inject.go（或 wire_gen.go），里面全是手写风格的初始化代码，例如 db := NewDB(); cache := NewCache(); handler := NewHandler(db, cache)
如果漏跑 wire build，go build 会报 undefined: NewApp 或 cannot use ... as ... value in return statement —— 因为生成文件没存在，编译器根本看不到那些函数

Wire 只看函数签名：参数类型决定“要什么”，返回类型决定“提供什么”。它不执行函数，只做静态推导。

初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。

下载

参数必须是具体类型（如 *sql.DB），不能是未定义别名（如 type DB *sql.DB）——除非你用 wire.Bind 显式绑定
返回值要是完整可推导的类型；若返回接口（如 Logger），必须确保 provider 返回的结构体指针实现了该接口，且最好用 wire.Struct 或 wire.Bind 辅助声明
避免副作用：不要在 NewDB() 里调 db.Ping() 或启 goroutine。Wire 生成的代码会在启动时无条件调它——失败就 panic，且这个 panic 发生在运行时，Wire 查不到
两个 provider 都返回 *redis.Client？Wire 直接报错。解决方式：用 wire.Value 绑定具体实例，或用 wire.Struct + 字段标签区分用途

必须提交。这不是缓存文件，是 Wire 工作流的硬性依赖。

inject.go 是产物，但不是可选产物；没有它，go build 就找不到 NewApp 等入口函数
常见错误：本地 .gitignore 写了 **/*.go 或 inject*，导致文件没进仓库；新成员拉代码后 go run main.go 直接失败
CI 流程中，务必在 go build 前加一步：wire build && go fmt ./ && go vet ./；否则生成逻辑和格式检查脱节，容易引入隐性 bug