go mod tidy 拉取不一致版本的根本原因是依赖图中多路径引入同一模块的不同版本，Go 依最小版本选择（MVS）规则自动升级，导致本地锁定版本与实际选用版本冲突。
为什么 go mod tidy 会拉取不一致的版本？
根本原因不是命令本身出错，而是模块依赖图中存在多个路径指向同一模块的不同版本。比如 A 依赖 B v1.2.0，而 C 同时依赖 B v1.3.0，Go 会按“最小版本选择（MVS）”规则选 B v1.3.0 —— 但如果你本地 go.mod 锁定的是 v1.2.0，go mod tidy 就可能报错或静默升级，导致行为不一致。
- 运行
go mod graph | grep 'module-name'查看该模块被哪些路径引入、各自指定什么版本 -
go list -m -u all能列出所有可升级的模块及当前最新兼容版 - 不要直接删
go.sum；它校验的是go.mod中声明的版本，删了反而让校验失效
如何强制统一某个依赖的版本？
用 replace 是最直接的干预方式，适用于你明确知道应锁定某版本、且该版本能兼容所有调用方的情况。
- 在
go.mod文件末尾添加：replace github.com/some/pkg => github.com/some/pkg v1.5.0
- 如果本地已 fork 并修复 bug，可指向本地路径：
replace github.com/some/pkg => ./vendor/github.com/some/pkg
- 执行
go mod tidy后，检查go.mod中是否仍存在其他版本的间接引用；若有，说明某依赖仍在显式要求旧版，需查清来源
遇到 invalid indirect dependency 怎么办？
这是 Go 1.16+ 的常见报错，本质是某个间接依赖（// indirect 标记）的版本被其上游撤回、重写 tag 或未发布到 proxy，导致校验失败。
