配置Go Module代理可解决国内依赖下载失败问题。使用go env -w设置GO111MODULE=on和GOPROXY=https://goproxy.cn,direct，推荐阿里云代理goproxy.cn提升下载速度。对于私有仓库如git.example.com，需配置GONOPROXY、GONOSUMDB和GOPRIVATE避免代理。通过go env验证配置，并用go get测试拉取效果，确认代理生效后即可稳定获取模块。
在国内使用 Golang 开发时，经常会遇到 go mod download 失败的问题，主要原因是部分模块托管在 GitHub 或境外服务器上，网络连接不稳定或被限制。为了解决这个问题，可以通过配置 Go Module 代理来加速依赖下载并避免超时失败。
启用 Go Module 并配置国内代理
从 Go 1.13 开始，Go Module 成为官方推荐的依赖管理方式。结合国内可用的公共代理服务（如 goproxy.cn 或 goproxy.io），可以显著提升模块拉取成功率。
推荐使用以下代理地址之一：
- https://goproxy.cn —— 阿里云维护，速度快，稳定性高
- https://goproxy.io —— 社区常用代理
- https://proxy.golang.org —— 官方代理（部分地区可能访问受限）
执行以下命令设置环境变量：
立即学习“go语言免费学习笔记（深入）”；
go env -w GO111MODULE=on go env -w GOPROXY=https://goproxy.cn,direct说明：
-
GO111MODULE=on强制启用模块模式 -
GOPROXY设置代理地址，多个用逗号分隔，direct表示对私有模块不走代理
处理私有模块（企业项目或内网仓库）
如果你的项目依赖公司内部 Git 仓库（如 GitLab、Gitee 私有库等），需要配置 GONOPROXY 和 GOPRIVATE 避免通过代理访问。
例如，忽略代理访问所有以 git.example.com 开头的模块：
go env -w GONOPROXY=git.example.com go env -w GONOSUMDB=git.example.com go env -w GOPRIVATE=git.example.com提示：
-
GONOPROXY指定不经过代理的模块前缀 -
GONOSUMDB忽略校验和数据库检查 -
GOPRIVATE综合控制私有模块行为（自动设置前两者）
验证配置是否生效
运行以下命令查看当前环境配置：
go env
确保输出中包含：
GO111MODULE="on" GOPROXY="https://goproxy.cn,direct"
然后尝试初始化一个项目测试下载：
mkdir testmod && cd testmod go mod init testmod go get github.com/gin-gonic/gin
如果能快速完成下载，说明代理配置成功。
基本上就这些。合理配置代理后，绝大多数依赖都能顺利拉取，不再受网络问题困扰。
