go mod download -x 能看到每个模块发起的 http 请求和 git 命令，精准定位卡点：dns 解析慢、tls 握手超时、响应下载慢或多次重试失败；若出现 get https://proxy.golang.org/ 说明 goproxy 未生效，常见原因为环境变量未继承、漏写 ,direct 或 goprivate 未覆盖私有路径。
go mod download -x 能看到什么真实耗时
加 -x 是定位延迟的第一步，它会打印出每个模块实际发起的 HTTP 请求和 git 命令。关键不是“有没有请求”，而是看每一步卡在哪：是 DNS 解析慢（lookup proxy.golang.org）、TLS 握手超时（dial tcp: i/o timeout）、还是响应体下载慢（GET https://goproxy.cn/.../@v/v1.2.3.info 后卡住数秒）。
常见现象：
- 看到
GET https://proxy.golang.org/...—— 说明GOPROXY没生效，子进程没读到环境变量 - 看到
git clone https://github.com/xxx/yyy—— 表示代理 fallback 到 direct，但该仓库可能需要认证或走 SSH，而go工具链默认不带凭据 - 同一 URL 多次重试（如
GET .../list连续失败三次）—— 往往是 CDN 缓存未刷新或镜像源同步延迟，不是你本地网络问题
GOPROXY 设置后仍走 proxy.golang.org 的三个漏点
很多人执行了 go env -w GOPROXY=https://goproxy.cn,direct，但 go mod download 还是连 proxy.golang.org。真正原因通常是以下三点中至少一个没做对：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
GOPROXY环境变量未被 shell 子进程继承：只改go env不够，必须在当前终端执行export GOPROXY=https://goproxy.cn,direct或重启终端 -
,direct被省略：没有它，私有模块（如git.internal.company.com/lib）会被代理强制转发，结果 403 或 404，Go 工具链自动 fallback 到默认值 -
GOPRIVATE没覆盖全部私有路径：比如设了GOPRIVATE=git.internal.company.com，但模块路径是git.internal.company.com/my/team/lib，Go 仍会尝试查公共代理；应写成GOPRIVATE=git.internal.company.com/*
如何区分是带宽瓶颈还是连接瓶颈
用 curl 手动模拟 Go 的请求路径，比看 go mod download 更准：
- 测 DNS 和连接：
time curl -I https://goproxy.cn/github.com/gin-gonic/gin/@v/v1.9.1.info -s -o /dev/null—— 如果real超过 1s，问题在 TLS 握手或网络可达性 - 测下载速度：
curl https://goproxy.cn/github.com/gin-gonic/gin/@v/v1.9.1.zip -o /dev/null，观察speed_download字段；低于 1MB/s 且稳定，才是带宽瓶颈 - 对比直连 vs 代理：把 URL 中的
goproxy.cn换成proxy.golang.org再试一次，如果后者完全不通而前者快，说明不是带宽问题，是代理配置或路由问题
checksum mismatch 不是网络问题，但会伪装成延迟
遇到 verifying github.com/xxx/yyy@v1.2.3: checksum mismatch，别急着换源或调大超时。这通常发生在模块内容已下载完成，但校验阶段卡住或失败：
- 本地缓存污染：执行
go clean -modcache后重试 - 镜像源未透传官方 sum：某些自建 proxy 或旧版
goproxy.io会返回错误哈希；确认你用的是goproxy.cn或mirrors.aliyun.com/goproxy，它们都同步sum.golang.org - 临时禁用校验仅用于验证：
GOSUMDB=off go mod download，若此时变快，说明问题出在校验环节，不是下载本身
真正容易被忽略的是：GOPROXY 配置正确、,direct 存在、GOPRIVATE 覆盖完整，这三个条件缺一不可；漏掉任一个，Go 就会在某个间接依赖上静默退回到 proxy.golang.org，让你以为“只有这个包慢”，其实是整个链路在 fallback。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
