冲突需手动干预，因同一模块多版本导致构建失败；用 go list -m all、go mod graph 和 go mod why 定位根源；replace 仅临时接管 import 解析，require 显式声明才是长期解法。
直接看 go list -m all 输出，如果同一模块路径（如 golang.org/x/net）出现两个不同版本，且编译或运行时报 undefined: Xxx.Method 或类型不匹配，说明冲突已实际影响构建——这时不能只靠 go mod tidy，必须手动干预。
怎么快速定位谁在拉旧版本
依赖冲突的根源永远是“谁引入了哪个版本”，不是“为什么没选对”。三个命令组合用，比翻 go.mod 高效得多：
-
go list -m all | grep 'golang.org/x/net'看当前实际加载了哪些版本（例如同时存在v0.17.0和v0.23.0） -
go mod graph | grep 'golang.org/x/net@'查哪条路径带入了旧版（输出形如my/project github.com/xxx/lib@v1.2.0→github.com/xxx/lib@v1.2.0 golang.org/x/net@v0.17.0） -
go mod why -m golang.org/x/net追最短引用链，确认是哪个子模块（比如auth或payment）强依赖了旧版
replace 不是补丁，是临时接管路径解析
replace 的作用不是“升级模块”，而是告诉 Go：“所有对这个路径的 import，都解析到我指定的目标”。它生效的前提很具体：
- 必须写在根
go.mod文件里，不能只改子模块的go.mod - 路径必须完全匹配，包括大小写和斜杠方向（
github.com/user/pkg≠Github.com/user/pkg） - 指向本地路径时，只能用绝对路径或相对于根模块的相对路径（
./common✅，../common❌） - 写完必须跟
go mod tidy，否则go.sum不更新，CI 构建可能失败
常见误用：用 replace 指向 fork 或 commit hash 后长期不清理。这会导致下游无法复现构建环境，且绕过校验和验证——只应在调试未发布分支或屏蔽 CI 中临时失败的间接依赖时使用。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
require 显式收敛才是长期解法
微服务中各子模块（auth/、user/）各自 go.mod 里写的 require，Go 不会自动合并。真正能强制统一版本的，是在根 go.mod 的 require 块里显式声明：
- 加一行
github.com/yourorg/utils v1.5.0 // indirect，再跑go mod tidy - MVS 会以该版本为基准重算整个图，迫使所有子模块接受这个版本（前提是 API 兼容）
- 如果某个子模块因 API 变更无法升级，说明它和主干已脱节，需单独评估迁移成本
注意：exclude 是彻底移除某版本，但它只在主模块生效，且不能排除主模块自己 require 的版本；而 replace 不阻止其他版本被间接引入，只接管 import 解析——两者的边界必须分清，混用容易导致行为不可预测。
最常被忽略的一点：冲突未必来自你写的代码，而是测试工具（如 ginkgo）、linter（如 staticcheck）或 vendor 目录偷偷拉进来的旧版。查 go list -m all 时别漏掉这些间接依赖，它们往往藏在 indirect 标记后面。
