根本原因是// +build wireinject标签缺失或格式错误，需确保首行无空格、无额外字符，且wire.go与目标包同级，仅含injector声明和wire.build()调用。
wire build 报 “no injector found” 怎么快速定位
根本原因几乎总是 // +build wireinject 标签缺失或格式错误。Wire 不会扫描普通注释，它依赖 Go 的构建约束机制识别入口文件。
- 第一行必须是
// +build wireinject，前面不能有空格，不能加逗号、分号或额外单词（比如// +build wireinject,linux就失效） - 该文件必须和目标包同级：比如你要生成
cmd/myapp/InitializeApp()，wire.go就得放在cmd/myapp/目录下，不能丢在项目根目录或internal/里 - 文件里只允许出现 injector 函数声明（如
func InitializeApp() *App）和wire.Build()调用，混入import或业务逻辑会导致 Wire 静默跳过 - IDE 自动格式化工具（如
gofumpt）可能删掉这行，建议把它加进 .gofumpt 配置的 ignore 列表
provider 函数返回 *sql.DB 却报类型不匹配
Wire 对类型完全严格匹配，*sql.DB 和 database/sql.DB（哪怕只是别名）算不同类型，接口实现也不自动转换。
- 确认 provider 返回类型和 injector 参数类型完全一致：比如 injector 声明要
*sql.DB，provider 就必须返回*sql.DB，不能是sqlx.DB或未导出别名type DB *sql.DB - 如果要用接口注入（如
type DB interface{...}），provider 必须直接返回该接口类型，或用wire.Bind显式绑定：wire.Bind(new(DB), new(*sql.DB)) - 基础类型如
string、int禁止直接作为 provider 返回值——容易冲突。应定义语义化别名：type MySQLDSN string，再让 provider 返回MySQLDSN
wire_gen.go 编译失败或本地能跑 CI 失败
这不是 Wire 本身的问题，而是构建产物未被正确纳入协作流程。生成的 wire_gen.go 是硬依赖，不是临时缓存。
-
wire_gen.go必须提交到 Git，且不能被.gitignore过滤——常见错误是写了**/*.go或inject*，结果把生成文件一起忽略了 - CI 流程中必须显式执行
wire build，不能只靠go build；建议在构建脚本开头加检查：git diff --quiet || (echo "wire_gen.go out of date"; exit 1) - 本地运行
wire build后，务必紧接着go build验证生成代码是否可编译——Wire 不报错 ≠ 生成代码没问题 - provider 函数体里有
db.Ping()、启动 goroutine 或读配置文件？Wire 不执行它们，但生成的初始化代码会在程序启动时无条件调用，失败就 panic
大型项目中 wire.Build() 参数越堆越多怎么管住
把所有 provider 塞进一个 wire.Build() 是反模式，会迅速失控。核心是按能力域收敛，而不是按文件路径组织。
- 每个子模块（如
auth、payment）导出自己的ProviderSet：var Set = wire.NewSet(NewService, NewRepo, NewDB) - 顶层
wire.go只组合这些 set：wire.Build(auth.Set, payment.StripeSet, cache.RedisSet)，不直接列函数名 - 避免跨模块循环引用：payment 不应直接依赖 auth.Set，而应通过接口 +
wire.Bind解耦，比如wire.Bind(new(auth.UserRepo), new(*auth.UserRepoImpl)) - 测试专用 set 单独建：
test.MockDBSet，只在测试 injector 中替换，不影响主流程
// +build wireinject 和 *sql.DB 类型对齐了，剩下的就是把依赖链显式列全——Wire 不猜，只照着你写的做。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
