go mod download拉到旧版本主因是代理镜像同步延迟、本地缓存残留或GOPRIVATE配置不全；应先curl验证镜像是否收录新tag，再清缓存（go clean -modcache）、精确配置GOPRIVATE并搭配,direct fallback。
go mod download拉到旧版本？先确认是不是代理没刷新
国内镜像源（如goproxy.cn）不是实时同步的，新发布的 tag 可能延迟 1–2 分钟才可被拉取。执行 go mod download 立即失败或返回旧版，并不等于模块不存在——只是镜像还没“看到”它。
- 验证方式：手动 curl
https://goproxy.cn/github.com/user/repo/@v/v1.2.3.info，若返回 404，说明镜像尚未收录；等 60 秒再试 - 临时绕过镜像：设
GOPROXY=direct直连 Git 源（需确保 Git 访问正常），命令为GOPROXY=direct go get github.com/user/repo@v1.2.3 - 别用
go get -u强制升级——它会按依赖图递归选“最新兼容版”，可能跳过你指定的 v1.2.3，改用go get github.com/user/repo@v1.2.3显式锁定
checksum mismatch 不是网速问题，而是缓存/代理不一致
报错 verifying github.com/user/repo@v1.2.3: checksum mismatch，大概率是本地缓存、镜像源、官方 sum 数据三者对不上。常见于镜像同步滞后或本地缓存残留旧校验值。
- 第一步清缓存：
go clean -modcache，删掉所有已下载模块及其.ziphash校验文件 - 第二步确认镜像是否透传校验：
goproxy.cn和mirrors.aliyun.com/goproxy都直透sum.golang.org，但自建 proxy 若漏配GOINSECURE或跳过校验，就会伪造哈希 - 临时调试可关校验：
GOSUMDB=off go mod download，但上线前必须恢复默认，否则失去依赖完整性保护
私有模块更新后仍拉旧版？检查 GOPRIVATE 是否覆盖完整路径
公司内部模块发布新 tag 后，go mod tidy 却始终拉不到，往往不是镜像问题，而是 GOPRIVATE 没写全，导致 Go 误走公共代理，而代理又查不到私有路径。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
GOPRIVATE必须匹配模块导入路径的**前缀**，例如模块路径是git.internal.company.com/team/lib，则GOPRIVATE=git.internal.company.com才生效；写成git.internal.company.com/team就漏掉子路径 - 多个域名用英文逗号分隔，**不能有空格**：
go env -w GOPRIVATE="git.internal.company.com,github.com/my-org/*" - 搭配
GOPROXY=https://goproxy.cn,direct才有效——,direct是关键，它让 Go 在匹配GOPRIVATE后自动 fallback 到直连，不尝试代理
go list -m all 显示版本对不上？可能是模块缓存未刷新
go list -m all 输出的版本，和 go.mod 里写的不一致，甚至和 go mod graph 里显示的间接依赖版本冲突——这通常是模块缓存中残留了旧 .info 文件，没随远程更新同步。
立即学习“go语言免费学习笔记（深入）”；
- 直接删对应模块缓存：
rm -rf $GOPATH/pkg/mod/cache/download/git.internal.company.com/@v/v1.2.2.info（把 v1.2.2 换成你要清理的旧版） - 或者暴力一点：
go clean -modcache，然后重新运行go mod download，强制重拉全部 - 注意：
go mod tidy默认不会主动刷新已缓存模块的 info 文件，除非go.mod里版本号变更或加了-compat=1.18这类参数
GOPRIVATE 是否精确匹配、以及是否在镜像未同步时及时切换 direct。这三个点卡住任何一个，都会让你以为“模块没发布”，其实只是路径没对上、缓存没清、或代理没退。 
