wire是编译期代码生成工具，非运行时框架；其核心要求包括：wire.go首行必须为严格格式的//+build wireinject标签、与目标包同级、仅含injector函数和wire.build()调用；漏标签、路径错或混入业务逻辑均导致静默忽略；生成的wire_gen.go是硬依赖，须提交git并纳入ci流程。
Wire 不是框架，它不参与运行时，也不提供任何“注入”魔法——你写的 NewService、NewDB 函数全得自己写，Wire 只负责在编译前把它们按依赖顺序拼成一个初始化函数。想靠它“自动管理依赖”，会卡在第一步就报错。
wire.go 文件为什么总被忽略？
根本原因不是路径错，而是构建标签失效。Go 构建系统靠 // +build wireinject 这行识别文件，它必须独占第一行、前后无空格、不能加逗号或额外 tag（比如 // +build wireinject,ignore 就无效）。
- 文件必须和目标包同级：你要生成
cmd/myapp/InitializeApp()，wire.go就得放在cmd/myapp/目录下，不能丢在项目根目录或internal/di/ - 文件里只允许三样东西：
injector函数（如func InitializeApp() *App）、wire.Build()调用、以及_ "github.com/google/wire"的空导入 - 混入
import "fmt"或变量声明，wire build会静默跳过整个文件，不报错也不生成
wire.Build() 漏传函数，为什么报错总指向“下游”类型？
Wire 不递归扫描代码库，它只信任 wire.Build() 显式列出的函数。漏掉中间 provider，生成链就断在那一层，而 Go 编译器报错永远指向“谁调用了缺失类型”，而不是“你漏了谁”。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 假设
InitializeApp → NewService → NewRepository → NewDB，但wire.Build(InitializeApp, NewService)里没写NewRepository和NewDB - Wire 会尝试生成
NewService的调用，发现它需要*Repository，但列表里没有返回*Repository的函数 → 报no provider found for *Repository - 它不会继续往下查“谁该提供
*Repository”，更不会提示“你漏了NewRepository”
两个函数都返回 *sql.DB，Wire 直接报错怎么办？
Wire 要求类型唯一可推导。同返回类型多 provider 是硬性禁止，函数名对 Wire 完全无意义。
- 不能靠
NewPrimaryDB()/NewReplicaDB()绕过 - 正确解法只有两种：
wire.Value(primaryDB)和wire.Value(replicaDB)绑定具体实例；或用wire.Struct按字段注入，例如wire.Struct(new(App), "primaryDB", "replicaDB") - 如果返回基础类型（如
string）冲突，必须用类型别名拆开：type DBDSN string和type RedisAddr string，再让对应 provider 分别返回
生成的 inject.go 为什么必须提交到 Git？
inject.go 不是缓存文件，是编译链的硬依赖。没有它，go build 就找不到 NewApp 等入口函数。
- 本地
.gitignore写了**/*.go或inject*，会导致文件没进仓库，新成员拉代码后go run main.go直接失败 - CI 流程中，务必在
go build前加一步：wire build && go fmt ./ && go vet ./ - 生成文件开头明确写着
// Code generated by Wire. DO NOT EDIT.，手动改等于自毁一致性
最常被忽略的一点：Wire 解决的是“构造顺序”和“类型连接”，不是“生命周期管理”。它不管对象销毁、复用、单例语义——这些得靠你设计 provider 函数本身来控制，比如在 NewDB() 里返回一个全局复用的 *sql.DB 实例，而不是每次都新建。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
