go模块本地编译超时90%源于gosumdb或goproxy配置失效；需执行go env -w goproxy=https://goproxy.cn,direct、go env -w gosumdb=off、go env -w goprivate=域名三步，并用go clean -modcache清缓存。
Go模块本地编译超时，90%不是网络差，而是模块校验卡在 GOSUMDB 或 GOPROXY 配置失效上；改对两个环境变量 + 一行命令就能绕过绝大多数 timeout。
go: google.golang.org/xxx: i/o timeout 错误本质
这个错误不是 Go 编译器卡住，而是 go mod download 阶段在尝试访问 https://proxy.golang.org 或 https://sum.golang.org 时 TCP 连接失败。Go 默认会并行做三件事：拉模块、验 checksum、查版本列表——只要其中任一环节超时（尤其是 sum 校验），整个构建就中断并报错。
- 常见现象：
go build卡在go: downloading ...后无响应，或反复重试同一模块 - 根本原因：GOSUMDB 默认指向
sum.golang.org，该域名在国内解析慢且常被阻断；GOPROXY 若未显式设置，会 fallback 到官方 proxy，同样不可达 - 注意：即使你设置了
GOPROXY=https://goproxy.cn，若没关掉 GOSUMDB，它仍会尝试连sum.golang.org做校验，导致 timeout
必须执行的三步配置（非可选）
以下操作直接解决 95% 的超时场景，无需重启终端（当前 shell 生效）：
- 运行
go env -w GOPROXY=https://goproxy.cn,direct—— 使用国内镜像拉模块，direct保证私有模块不走代理 - 运行
go env -w GOSUMDB=off—— 彻底禁用 checksum 校验（开发/内网环境安全；生产如需校验，改用sum.golang.org+https://goproxy.cn组合） - 运行
go env -w GOPRIVATE=git.example.com,github.com/myorg（如有私有模块）—— 防止 GOPROXY 错误拦截内部路径
验证是否生效：执行 go env | grep -E "(GOPROXY|GOSUMDB|GOPRIVATE)"，确认输出值与上述一致。
仍超时？检查这三类隐藏卡点
配置正确但还卡，说明问题出在更底层：
-
go mod download -x输出中若出现verifying ...: checksum mismatch，说明本地缓存损坏，运行go clean -modcache清空后重试 - 项目含
cgo且CGO_ENABLED=1（默认），C 编译器调用可能触发 DNS 查询失败；临时加CGO_ENABLED=0测试是否缓解 - Windows 下若启用
MSMANAGER或PCManager Service Store等系统服务，会劫持进程创建并拖慢模块解压——任务管理器中结束对应服务进程即可
不推荐但应急可用的方案
当完全无法联网或代理也不通时，可用本地模块替代远程依赖：
- 手动下载模块 zip 包（如从
https://goproxy.cn/google.golang.org/protobuf/@v/v1.34.2.zip），解压到$GOPATH/pkg/mod/cache/download/google.golang.org/protobuf/@v/v1.34.2.zip - 在
go.mod中添加replace google.golang.org/protobuf => ./vendor/protobuf，把解压目录软链过去 - 注意：
replace不会自动下载依赖，需确保目标路径下已存在完整模块源码（含go.mod）
真正难处理的永远不是第一次超时，而是 GOSUMDB=off 后又忘了开回来——上线前务必检查 checksum 是否重新启用，否则依赖篡改风险无法兜底。
