配置Go模块代理可解决国内下载依赖缓慢问题,推荐设置GOPROXY为https://goproxy.cn,direct,并通过GOPRIVATE排除私有仓库,如git.company.com,确保安全与效率。

在使用 Golang 进行开发时,尤其是在国内网络环境下,直接从 golang.org 下载模块可能会非常缓慢甚至失败。为了解决这个问题,可以通过配置 Go 模块代理来加速依赖包的下载。
启用 Go Modules 并配置国内代理
Go 1.13 及以上版本默认开启 Go Modules 功能。为了提升模块拉取速度,建议将 GOPROXY 设置为国内可用的镜像地址。
推荐使用以下代理:
设置方法如下:
立即学习“go语言免费学习笔记(深入)”;
go env -w GOPROXY=https://goproxy.cn,direct其中 direct 表示对于某些私有模块或特殊域名,跳过代理直接连接源地址。
处理私有模块或企业仓库
如果你的项目依赖了私有 Git 仓库(如 GitHub 私有库、GitLab 自建服务),需要避免这些请求走代理。
通过设置 GOPRIVATE 环境变量告诉 Go 哪些模块不经过代理:
go env -w GOPRIVATE=git.company.com,github.com/your-private-repo也可以结合正则匹配,例如:
go env -w GOPRIVATE=*.company.com验证代理配置是否生效
执行以下命令查看当前环境配置:
go env确认输出中包含:
- GOPROXY=https://goproxy.cn,direct
- GOPRIVATE=...(如有设置)
尝试运行 go get 获取一个外部模块,观察下载速度和是否成功。
基本上就这些。合理配置代理后,模块下载会变得顺畅很多,特别是在 CI/CD 或新机器初始化时效果明显。










