Go模块代理用于加速依赖下载，解决国内访问golang.org/x等域名受限问题。通过设置GOPROXY环境变量可指定代理地址，如https://goproxy.cn（推荐）、https://goproxy.io或官方proxy.golang.org；使用go env -w GOPROXY=https://goproxy.cn,direct进行配置，其中direct表示跳过代理直接拉取。若项目包含私有模块（如企业内网仓库），需设置GOPRIVATE避免代理，例如go env -w GOPRIVATE=git.company.com,github.com/organization/private-repo，支持通配符*.company.com。可配置多代理实现容错，如GOPROXY=https://goproxy.cn,https://proxy.golang.org,direct，Go会按顺序尝试，direct必须置于末尾以终止链路。验证可通过go get命令观察下载路径，或执行go env GOPROXY GOPRIVATE查看当前配置。正确设置能显著提升依赖拉取稳定性与速度，关键细节包括direct位置和私有模块排除。

Go 模块代理的作用是加速依赖包的下载，尤其在使用 go modules 时，国内开发者常因网络问题无法访问 golang.org/x 等域名。通过设置模块代理，可以稳定、快速地拉取第三方包。以下是 Golang 模块代理的常用设置方式和实践建议。

配置 GOPROXY 环境变量

GOPROXY 是 Go 1.13+ 引入的核心环境变量，用于指定模块代理地址。推荐使用以下公共代理：

• https://proxy.golang.org（官方，部分地区受限）
• https://goproxy.cn（国内推荐，由七牛云维护）
• https://goproxy.io（国内可用）

设置方法（以 goproxy.cn 为例）：

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

其中 direct 表示对于私有模块或特定域名可跳过代理直接拉取。

立即学习“go语言免费学习笔记（深入）”；

处理私有模块（GOPRIVATE）

若项目中包含企业内网 Git 仓库（如 GitLab、GitHub Private），需避免通过代理拉取，可通过 GOPRIVATE 忽略代理：

GitHub操作助手

用大白话操作当前项目的 Git/GitHub——配置 GitHub（装 gh CLI + 登录 + 建仓库）、备份、拉取下载、查询历史、回滚代码、管理分支。当用户用日常语言表达 git 意图时触发（例如"git备份一下""git下载项目""git拉下来""git看看我改了啥""git回退到上一个版本""git新建个分支搞新功能""git合并到主分支""git

下载

go env -w GOPRIVATE=git.company.com,github.com/organization/private-repo

也可结合正则匹配：

go env -w GOPRIVATE=*.company.com,*.internal

多代理与容错配置

支持多个代理地址，用逗号分隔，Go 会按顺序尝试：

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

当第一个代理不可用时，自动尝试下一个。注意：direct 必须放在最后，表示终止代理链。

验证代理是否生效

执行任意模块操作（如获取包）并查看请求路径：

go get github.com/gin-gonic/gin

观察是否从代理地址下载。也可通过如下命令查看当前配置：

go env GOPROXY GOPRIVATE

基本上就这些。合理设置 GOPROXY 和 GOPRIVATE 能显著提升开发效率，避免依赖拉取失败。不复杂但容易忽略细节，比如 direct 的位置和私有模块的排除。