Golang设置国内GOPROXY镜像加速方法

Go 1.13+ 默认启用 Go Module，但国内访问官方代理 proxy.golang.org 常遇超时或失败，严重影响 go get 和 go mod download 等操作的效率与稳定性；本文详解如何快速配置国内高效 GOPROXY 镜像（首推七牛云的 https://goproxy.cn），涵盖临时与永久设置方法（适配 Zsh/Bash/PowerShell）、关键参数 ,direct 的作用、生效验证步骤，以及极易被忽视却至关重要的 GO111MODULE=on 全局启用提醒——只需几分钟配置，即可彻底告别模块下载卡顿，大幅提升 Golang 开发体验。

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）拉取，避免私有模块无法下载。

永久设置（推荐）

将环境变量写入 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。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~