Go依赖下载失败的三大原因及解决方法：一是检查GOPROXY是否生效，推荐设为“https://goproxy.cn,direct”；二是处理GOSUMDB校验阻塞，可设为“sum.golang.google.cn”或临时关闭；三是清理缓存（go clean -modcache和-go clean -cache）并验证网络连通性。
Go依赖下载失败，核心就三点：网络通路、代理配置、校验机制。不是所有报错都该重试，得先看清楚是卡在哪一环。
检查 GOPROXY 是否生效
这是最常被忽略的第一步。运行 go env GOPROXY，确认输出不是空或 direct（默认值）。国内用户推荐设为：
- https://goproxy.cn,direct（主备 fallback，稳定常用）
- 或更全一点：https://goproxy.cn,https://goproxy.io,direct
设置命令：
go env -w GOPROXY="https://goproxy.cn,direct"
改完后新开终端再验证，IDE（如GoLand）需重启或重载环境变量。
确认 GOSUMDB 校验是否阻塞
模块校验数据库 sum.golang.org 在国内常超时或不可达，导致 go get 或 go mod download 卡住。可临时关闭，或切换为国内镜像：
- 关掉校验（开发阶段可接受）：go env -w GOSUMDB=off
- 启用国内校验服务（推荐）：go env -w GOSUMDB=sum.golang.google.cn
注意：关闭校验会跳过包完整性检查，上线前建议恢复并用可信代理。
清理缓存再重试
缓存损坏或混入失败中间状态，会导致后续操作持续失败。执行两步清理：
Productivity Google Workspace
下载
Access Gmail, Calendar, Drive, Docs, and Sheets via the gws CLI or Python.
- go clean -modcache（清模块下载缓存）
- go clean -cache（清构建缓存）
清理后直接运行 go mod download 或 go mod tidy，避免用 go get 混合触发旧逻辑。
验证网络与基础连通性
别急着调代理，先确认底层是否可达：
- 手动 curl 测试代理地址：curl -I https://goproxy.cn/health（应返回 200）
- 检查能否访问 proxy.golang.org（官方默认 fallback）
- 企业网络下，确认是否需额外 HTTP/HTTPS 代理（
http_proxy环境变量）
如果 curl 都失败，问题不在 Go 配置，而在系统网络或防火墙策略。
基本上就这些。不复杂但容易忽略——多数情况只需设对 GOPROXY + GOSUMDB，再清一次缓存，90% 的依赖失败就解决了。
