默认 goproxy 在大项目中卡住是因为 proxy.golang.org 国内不稳定，且 go 串行拉取上百依赖时单点超时或 502 会阻塞全局；需配置多级 fallback 代理链（如 goproxy.cn|aliyun|tencent|direct）、同步调整 gosumdb（推荐 off 或 sum.golang.google.cn），并正确设置 goprivate 隔离私有模块。
为什么直接用默认 GOPROXY 在大项目里会卡住
因为默认的 https://proxy.golang.org 在国内访问不稳定，而大项目往往有几十甚至上百个间接依赖，每个依赖又可能带多个子模块。Go 的 go mod download 或 go build 会串行尝试解析并拉取所有模块，一旦某个代理节点超时或返回 502，整个流程就卡在那个模块上，甚至触发重试退避机制，导致首次构建动辄几分钟。
配置多级 fallback 的 GOPROXY 链式策略
不是简单换一个镜像，而是让 Go 主动按顺序试多个源，避免单点失败阻塞全局：
-
GOPROXY="https://goproxy.cn|https://mirrors.aliyun.com/goproxy|https://mirrors.tencent.com/go|direct"—— 注意用竖线|分隔，不是逗号；Go 1.15+ 才支持该语法 -
goproxy.cn响应快、缓存全，适合作为首选；aliyun和tencent作为冗余备份，覆盖不同 CDN 节点 - 末尾保留
direct是关键：当所有代理都无响应时，Go 会回源到原始仓库（如 GitHub），避免完全失败 - 不要把
direct放最前——否则等于没开代理，依然走慢速直连
GOSUMDB 必须同步关闭或替换，否则校验卡死
默认 GOSUMDB=sum.golang.org 同样受网络影响，且它不支持代理转发。大项目里成百上千个模块都要逐个校验，只要一个模块的 checksum 查询超时，go mod download 就会 hang 住。
- 推荐设为
GOSUMDB=off（开发/内网环境）或GOSUMDB=sum.golang.google.cn（国内可用镜像） - 若必须启用校验，且使用私有模块，可组合设置：
GOPRIVATE=git.example.com,github.com/myorg/*，这样匹配的模块跳过GOSUMDB校验 - 注意：
GOSUMDB=off不影响go.sum文件生成和比对，只跳过远程校验请求
go mod download 加 -x 参数定位具体卡在哪
当下载慢得无法判断原因时，别只等，用 -x 看真实执行流：
go mod download -x
输出会显示每个模块的 fetch URL、curl 命令、HTTP 状态码。常见卡点包括：
-
GET https://proxy.golang.org/github.com/sirupsen/logrus/@v/v1.9.0.info返回 502 或 timeout → 说明代理失效 -
GET https://goproxy.cn/github.com/gorilla/mux/@v/v1.8.0.mod响应正常但后续.zip下载极慢 → 可能是镜像节点带宽瓶颈，换下一个代理 - 某私有模块路径（如
git.internal.company/pkg）被错误送进代理 → 检查GOPRIVATE是否漏配
真正拖慢大项目的，从来不是“没配代理”，而是代理链没 fallback、校验没绕过、私有模块没隔离——这三个点漏掉任意一个，go mod tidy 都可能卡在第 47 个依赖上不动。
