Go模块新tag找不到主因是镜像异步同步延迟，需用curl验证镜像版本列表、设GOPROXY=direct确认是否真问题，并确保GOPRIVATE完整覆盖私有域名、direct置于GOPROXY末尾。
go get 找不到新发布的 tag 是镜像没同步，不是你写错了
国内主流 Go 代理（如 https://goproxy.cn）不是实时镜像，而是异步拉取上游 GitHub/GitLab 的模块快照。当你刚打完 v1.2.3 tag 并推送到 GitHub，go get example.com/lib@v1.2.3 很可能立刻失败——这不是网络或配置问题，是镜像站还没收录这个版本。
- 用
curl -s "https://goproxy.cn/example.com/lib/@v/list" | tail -n 5查看镜像当前已知的版本列表，确认v1.2.3是否在其中 - 不要等“过几分钟就自动好了”，有些镜像同步周期长达数小时；生产环境发布后应主动触发同步（若你有管理权限）或换源验证
- 临时绕过镜像：设
GOPROXY=direct再试go get，若成功说明纯属镜像延迟，不是代码或 tag 本身有问题
多个 GOPROXY 源串联时，顺序决定 fallback 行为
Go 会按 GOPROXY 值中逗号分隔的顺序依次尝试，直到某个源返回非 404/403 响应才停止。如果把 direct 放在中间或前面，会导致本该由镜像服务的公共包被直连，失去加速和缓存优势；放错位置还会让私有模块无法 fallback。
- 正确顺序必须是镜像地址在前、
direct在末尾，例如：https://goproxy.cn,https://mirrors.aliyun.com/goproxy/,direct - 不要用分号或空格分隔，Go 只认英文逗号；
direct后不能跟空格或换行，否则会被截断失效 - 若公司有自建代理（如 Nexus），把它放在
direct之前、公共镜像之后，优先走内网缓存
go list -m -versions 报 404 不代表模块不存在，只代表当前代理没索引
go list -m -versions github.com/user/repo 依赖代理返回 @v/list 接口，而该接口内容完全由镜像站本地缓存决定。它返回 404 ≠ 模块不存在，只是当前代理尚未收录任何版本。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 验证是否真不可用：改用
GOPROXY=direct go list -m -versions github.com/user/repo，能列出版本说明模块本身正常 - 想强制刷新镜像缓存？多数公共镜像不提供手动触发入口；可换用
https://proxy.golang.org（虽慢但更新略快）对比结果 - CI/CD 中遇到此问题，建议加一层重试逻辑：先用主镜像，超时后切
direct再试一次，避免构建因镜像延迟失败
私有模块打 tag 后找不到，大概率是 GOPRIVATE 没配全
即使设置了 GOPROXY=https://goproxy.cn,direct，Go 仍会把匹配 GOPRIVATE 的域名请求发给代理（而非直连），因为 direct 只对「未命中任何镜像」生效，而私有域名常被镜像站主动拦截或返回 404。
立即学习“go语言免费学习笔记（深入）”；
-
GOPRIVATE必须显式包含完整域名，比如gitlab.example.com，不能只写example.com（子域名不自动继承） - 多个域名用逗号分隔：
go env -w GOPRIVATE=gitlab.internal,github.company.com - 配完后，Go 会跳过代理直接走 git clone 或 HTTPS 下载，不再查
@v/list—— 所以 tag 发布后就能立刻被识别
GOPRIVATE 覆盖是否完整、direct 是否真的在 GOPROXY 末尾、以及 CI 环境里这些变量有没有被覆盖或清空。 
