Go 1.13+默认启用Go Module,需配置GOPROXY使用国内镜像(如https://goproxy.cn)提升下载速度与稳定性,并确保GO111MODULE=on以启用模块功能。

Go 1.13 及以后版本默认启用了 Go Module,并通过 GOPROXY 环境变量控制模块代理。国内直接访问官方 proxy.golang.org 常常超时或失败,设置国内镜像可显著提升 go get、go mod download 等操作的速度和稳定性。
常用国内 GOPROXY 镜像地址
目前稳定、同步及时的主流镜像有:
- https://goproxy.cn(由七牛云维护,国内访问快,推荐首选)
- https://goproxy.io(已停止维护,不建议新项目使用)
- https://mirrors.aliyun.com/goproxy/(阿里云镜像,同步较稳定)
- https://goproxy.bytom.io(Bytom 提供,可用但更新频率略低)
临时设置(当前终端生效)
仅对当前命令行窗口有效,适合快速测试:
export GOPROXY=https://goproxy.cn,direct
注意末尾的 ,direct 表示:当镜像中找不到模块时,回退到直接从模块源(如 GitHub)拉取,避免私有模块无法下载。
立即学习“go语言免费学习笔记(深入)”;
永久设置(推荐)
将环境变量写入 shell 配置文件,重启终端或执行 source 生效:
- Zsh(macOS Catalina 及以后 / Linux 默认):
echo "export GOPROXY=https://goproxy.cn,direct" >> ~/.zshrc && source ~/.zshrc - Bash:
echo "export GOPROXY=https://goproxy.cn,direct" >> ~/.bashrc && source ~/.bashrc - Windows(PowerShell):
[System.Environment]::SetEnvironmentVariable('GOPROXY','https://goproxy.cn,direct','User')
验证是否生效
运行以下命令查看当前 GOPROXY 配置:
go env GOPROXY
输出应为 https://goproxy.cn,direct 或你设置的其他地址。再尝试拉一个模块测试:
go mod init example.com/test && go get github.com/gin-gonic/gin@v1.9.1
若能快速完成下载并生成 go.sum,说明配置成功。
不复杂但容易忽略的是:确保没有在项目目录下或全局设置了 GO111MODULE=off,否则 Module 功能被禁用,GOPROXY 也不会起作用。推荐始终开启:go env -w GO111MODULE=on。










