启用国内代理如goproxy.cn,配置GOPROXY和GOPRIVATE区分公私模块,优化GOSUMDB与本地缓存,可显著提升Go模块下载速度。

Go 模块下载慢是开发者在国内常见的问题,主要因为默认的模块代理(proxy.golang.org)被网络限制。解决这一问题的核心思路是使用国内镜像、配置代理和优化环境设置。以下是几种实用且有效的优化方法。
启用 GOPROXY 代理
Go 1.13+ 支持通过 GOPROXY 环境变量指定模块代理,推荐使用国内稳定镜像:
- https://goproxy.cn:七牛云维护的公共代理,速度快,支持校验和透明日志
- https://goproxy.io:社区维护的镜像,稳定性较好
- https://proxy.golang.com.cn:阿里云推出的 Go 模块代理
设置命令:
go env -w GOPROXY=https://goproxy.cn,direct
多个代理可用逗号分隔,direct 表示最终回退到源站。
立即学习“go语言免费学习笔记(深入)”;
配置私有模块不走代理
如果公司使用私有模块(如 GitLab 或 GitHub 私有仓库),需避免这些模块被代理拦截。
使用 GOPRIVATE 告诉 Go 哪些模块不经过代理:
go env -w GOPRIVATE=git.company.com,github.com/your-org
也可结合正则匹配,例如:
go env -w GOPRIVATE=*.company.com
使用 GOSUMDB 绕过校验延迟
Go 默认会验证模块完整性,但 sum.golang.org 在国内访问不稳定,可能导致卡顿。
若使用可信代理(如 goproxy.cn 已做校验),可关闭或替换校验服务:
go env -w GOSUMDB="sum.golang.org https://goproxy.cn"
或完全禁用(仅限内网安全环境):
go env -w GOSUMDB=off
优化本地缓存与网络请求
Go 模块会缓存到本地,合理利用缓存能减少重复下载。
- 模块缓存路径为 $GOPATH/pkg/mod 或 $GOCACHE
- 避免频繁清理 mod cache,除非出现冲突
- 使用 go clean -modcache 清理时要谨慎
若网络环境差,可尝试设置超时时间:
export GODEBUG=netdns=go
强制 Go 使用纯 Go DNS 解析,避免系统 DNS 拖慢速度。
基本上就这些。配置好 GOPROXY 和 GOPRIVATE 后,大多数下载问题都能解决。关键是选对代理,区分公私模块,再稍作调优,体验会明显提升。不复杂但容易忽略细节。










