Go模块下载延迟主因是proxy.golang.org国内不可达且GOPROXY未生效；需确保GOPROXY含,direct、GOPRIVATE覆盖私有路径、子进程实际读取到该变量，再通过go mod download -x验证请求地址。
冷启动构建场景下，Go模块下载延迟不是网络差导致的，而是默认代理 proxy.golang.org 在国内不可达 + GOPROXY 未真正生效造成的。只要三个关键点全对上——GOPROXY 值含 ,direct、GOPRIVATE 覆盖私有路径、子进程实际读取到该变量——90% 的“卡住”问题当场消失。
go mod download 卡在 dial tcp: i/o timeout 怎么快速定位
这不是 DNS 或防火墙问题，是 Go 工具链 fallback 到了默认代理。验证方式只有一种：加 -x 看真实请求地址。
- 运行
go mod download -x github.com/gin-gonic/gin@v1.9.1 - 如果日志里出现
GET https://proxy.golang.org/或git clone，说明GOPROXY没被当前 go 进程读到 - 常见漏点：
go env -w GOPROXY=...执行了，但 Shell 没export，或 IDE（如 VS Code）没重载环境变量 - 终端里直接跑
echo $GOPROXY，输出为空就铁定没继承
Docker 构建中依赖反复下载的根本原因
多阶段构建若没分离 go.mod 和代码，Docker 缓存就失效，每次 build 都重新 go mod download。
- 必须先
COPY go.mod go.sum .，再RUN go mod download，之后才COPY . . - 否则任意源码变更都会让前面所有 layer 失效，包括依赖下载步骤
- CI/CD 中若用
docker build --no-cache，那更得确保go mod download这步本身不依赖网络——靠GOPROXY和,direct保证 - 镜像内不建议用
go install安装工具（如golangci-lint），它也走GOPROXY，但某些旧 Go 版本对,direct回退有 bug，可补上https://proxy.golang.org,direct作兜底
GOPROXY 设置后仍 checksum mismatch 怎么办
这不是代理慢，是哈希校验失败，通常和缓存污染或镜像同步延迟有关。
- 先清本地缓存：
go clean -modcache，再重试 - 确认你用的镜像是否透传官方
sum.golang.org记录：goproxy.cn和mirrors.aliyun.com/goproxy/支持，但部分自建 proxy 若漏配GOINSECURE或跳过校验，就会返回错误哈希 - 临时调试可用
GOSUMDB=off，但上线前必须关掉——否则失去依赖完整性保护 - 刚发布的模块（比如
v1.2.3）在goproxy.cn返回 404，等 1–2 分钟或切到https://goproxy.io（注意：该站已停服，仅作临时 fallback）
真正卡住的地方，往往不是“要不要换源”，而是 GOPROXY 是否被所有子进程正确读取、,direct 是否启用、GOPRIVATE 是否覆盖全部私有路径——这三个点漏掉任何一个，都可能让下载行为退回到默认代理，白配。
