go env -w GOPROXY=https://goproxy.cn,direct go env -w GOPRIVATE=git.company.com/* go clean -modcache go mod tidy
执行 go mod tidy 时卡住，最后提示某个模块版本未知，内网环境更明显。先别急着动参数，把报错原文和时间点记下来，顺序反了容易白折腾。
原因不复杂，默认代理访问不到目标仓库，或私有模块没有配置跳过代理，内网机器上还会叠加证书与域名解析问题。
「Go 模块拉取失败」确认了原因之后，改动尽量只碰那一处，顺手改的东西后面最容易出问题。改动写完就同步给同事，下一个人踩同一个坑，成本还是你的。
验证用真实数据走一遍，测试数据太干净，边界情况根本碰不到。能分两步做的操作就别合成一步，中间看一眼返回值，出问题好判断。
报错里带路径的，先去看那个路径在不在、权限对不对。同一份配置存在多处的，先确认改的是被加载的那一份。
处理上按这个顺序：设置可用的模块代理；私有仓库加入 GONOSUMDB 与 GOPRIVATE；清理缓存重试。
改完只确认一件事：依赖能全部下载成功，go build 通过且不再提示版本未知。