Golang模块代理设置教程\_GoProxy加速配置详解

正确设置GOPROXY可显著提升Go模块下载速度，推荐使用https://goproxy.cn等国内代理，通过go env -w配置并结合GONOPROXY处理私有模块，优化构建体验。

Go 模块代理能显著提升依赖包的下载速度，尤其在使用国内网络访问境外资源时。自 Go 1.13 起，模块代理（GOPROXY）已成为标准配置项，合理设置可避免超时、失败等问题。

什么是 GOPROXY

Go 模块代理是一个 HTTP 服务，用于缓存和分发 Go 模块。通过设置 GOPROXY 环境变量，可以指定 go 命令从哪个地址拉取模块数据。默认情况下，Go 直接从版本控制系统（如 GitHub）下载，但受网络影响较大。

启用代理后，go 命令会优先从代理服务器获取模块信息和源码压缩包，提高稳定性与速度。

常用 Go 模块代理地址

以下是国内开发者常用的公共 Go 模块代理源：

• https://goproxy.cn：中国官方推荐镜像，由阿里云维护，稳定可靠。
• https://goproxy.io：社区维护的国内加速代理。
• https://proxy.golang.org：Google 官方代理，海外用户首选，部分地区可能受限。

多个代理可用逗号分隔，形成备用链。例如：

GOPROXY=https://goproxy.cn,direct

其中 direct 表示终止代理链，直接下载，常用于私有模块跳过代理。

配置 GOPROXY 的方法

可通过环境变量或命令行方式设置代理。

查看当前配置：

go env

设置代理（以 goproxy.cn 为例）：

go env -w GOPROXY=https://goproxy.cn,direct

该命令将配置写入全局环境，永久生效。若只想临时使用，可在 shell 中导出：

export GOPROXY=https://goproxy.cn,direct

Windows 用户可用：

setx GOPROXY "https://goproxy.cn,direct"

私有模块如何绕过代理

企业项目常使用私有仓库（如 GitLab、GitHub Enterprise），这些模块不应走公共代理。

通过 GONOPROXY 变量指定不走代理的模块路径前缀：

go env -w GONOPROXY=git.company.com,github.com/myorg

同时建议设置 GONOSUMDB 和 GOPRIVATE，避免校验和错误：

go env -w GONOSUMDB=git.company.com
go env -w GOPRIVATE=git.company.com

GOPRIVATE 可自动设置 GONOPROXY 和 GONOSUMDB，简化配置。

基本上就这些。正确设置 Go 模块代理后，go mod tidy、go get 等命令会明显变快，构建体验大幅提升。不复杂但容易忽略。