Go 1.13+默认代理proxy.golang.org国内访问慢,推荐设为https://goproxy.cn,direct,支持临时export或永久go env -w设置,并可追加私有仓库例外。

在 Go 1.13 及以后版本中,模块镜像(Go Proxy)是提升依赖下载速度和稳定性的核心机制。默认使用 proxy.golang.org,但国内用户常因网络问题无法访问或速度极慢,此时配置国内可信镜像(如阿里云、中科大、七牛等)可显著改善体验。
查看当前 GOPROXY 设置
运行以下命令确认当前代理配置:
go env GOPROXY若输出为 https://proxy.golang.org,direct 或空值,则说明未启用国内镜像,需手动设置。
临时设置模块镜像(当前终端有效)
适用于测试或 CI 环境,不改变全局配置:
立即学习“go语言免费学习笔记(深入)”;
- Linux/macOS:export GOPROXY=https://goproxy.cn,direct
- Windows(PowerShell):$env:GOPROXY="https://goproxy.cn,direct"
- Windows(CMD):set GOPROXY=https://goproxy.cn,direct
永久设置模块镜像
推荐方式,一劳永逸:
- 执行命令写入 Go 环境变量:go env -w GOPROXY=https://goproxy.cn,direct
- 若需支持私有模块(如公司内网仓库),可追加例外规则,例如:
go env -w GOPROXY=https://goproxy.cn,https://proxy.golang.org,direct
其中direct表示对匹配不到的模块(如未公开的私有域名)直接拉取,不走代理 - 验证是否生效:go env GOPROXY 应返回新值
常用可靠镜像地址(国内推荐)
以下镜像均支持 HTTPS、缓存完整、更新及时,任选其一即可:
-
阿里云:
https://goproxy.cn(推荐,稳定性高,CDN 加速好) -
中科大:
https://mirrors.ustc.edu.cn/goproxy/(学术背景强,适合教育网用户) -
七牛云:
https://goproxy.qiniu.com(响应快,兼容性好)
注意:多个镜像可用英文逗号分隔,Go 会按顺序尝试,遇到失败自动降级到下一个;direct 必须放在末尾作为兜底。










