解决Golang模块依赖加载速度缓慢的优化策略-Golang-PHP中文网

根本原因是默认代理proxy.golang.org对国内节点未优化，应设goproxy=https://goproxy.cn,direct并验证生效，同时配gosumdb避免校验失败，清缓存可解决checksum mismatch。

解决golang模块依赖加载速度缓慢的优化策略

go mod download 卡在 proxy.golang.org 怎么办

根本不是你网络差，而是 Go 默认代理 proxy.golang.org 对国内节点没做优化，DNS 污染、TLS 握手超时、连接复用失败都会触发重试+退避，看起来像“卡住”。真实现象常是：命令停在某个模块几秒不动，然后报 Get "https://proxy.golang.org/": dial tcp: i/o timeout。

必须设 GOPROXY 环境变量（不是只改 go env -w），推荐值：https://goproxy.cn,direct。,direct 是关键——它让私有模块（如 git.internal.company.com/my/lib）自动 fallback 到直连，不走代理。

别信“改完 go env -w GOPROXY=... 就完事”，Shell 启动新进程若没继承环境变量，go 命令仍读空值。验证是否生效，跑：
go mod download -x github.com/gin-gonic/gin@v1.9.1，看日志里是不是出现 GET https://goproxy.cn/...；如果还是 proxy.golang.org 或直接 git clone，说明没生效。

为什么设了 GOPROXY 还 404 或 checksum mismatch

goproxy.cn 是镜像服务，不是加速器，速度取决于你机器到七牛节点的网络质量，并非所有地区都快。刚发布的模块（比如 v1.2.3 发布后 1–2 分钟内）可能因 CDN 缓存未刷新而返回 404 Not Found，等几分钟或临时切 https://goproxy.io（注意：该站已停服，实际应换 https://mirrors.aliyun.com/goproxy/）。

checksum mismatch 不是网速问题，是校验失败：模块内容和 sum.golang.org 记录的哈希不一致。常见于镜像同步延迟、中间代理篡改或本地缓存污染。

先清缓存：go clean -modcache
确认镜像源是否透传官方校验 —— goproxy.cn 和 mirrors.aliyun.com/goproxy 都支持，但某些自建 proxy 若跳过校验就会出问题
临时绕过（仅调试）：GOSUMDB=off，但上线前必须关掉

私有模块拉不到或认证失败怎么处理

goproxy.cn 不支持私有模块鉴权。如果你的 go.mod 里写了 replace example.com/internal => git@git.example.com/internal v0.0.0-20230101000000-abc123，而 Git 服务器需要 SSH key 或 HTTP Basic Auth，代理无法帮你登录。