启用国内代理如goproxy.cn，配置GONOPROXY跳过私有模块，清理modcache缓存，验证模块版本与网络连通性，可解决Go模块下载失败问题。
Go 模块下载失败是开发中常见的问题，尤其在使用国内网络环境时。这类问题通常表现为 go get 失败、超时、连接被拒绝或返回 404 错误。解决这类问题需要从代理配置、模块镜像、缓存清理和版本控制等多方面入手。
启用 Go 模块代理
Go 1.13+ 默认启用模块模式，但默认的下载源 proxy.golang.org 在国内访问困难。设置国内可用的代理能显著提升下载成功率。
推荐使用以下任一代理：
- https://goproxy.cn（七牛云维护，国内推荐）
- https://goproxy.io（社区维护）
- https://proxy.golang.com.cn（阿里云提供）
执行命令设置代理：
立即学习“go语言免费学习笔记（深入）”；
go env -w GOPROXY=https://goproxy.cn,direct
其中 direct 表示对私有模块不走代理，可根据需要保留。
配置私有模块跳过代理
若项目依赖公司内部 Git 仓库模块（如 GitHub Enterprise 或 GitLab），需避免这些请求被代理。
使用 GONOPROXY 和 GONOSUMDB 环境变量指定例外：
go env -w GONOPROXY=git.company.com,github.com/company go env -w GONOSUMDB=git.company.com,github.com/company
这样，go get 遇到这些域名时将直接克隆，不会尝试通过代理获取。
清除缓存并重试下载
有时模块缓存损坏会导致反复失败。可清除下载缓存后重试：
go clean -modcache
该命令会删除所有已下载的模块，之后再次运行 go mod tidy 或 go build 会重新拉取依赖。
若怀疑校验和不匹配，也可临时关闭校验（仅用于调试）：
go env -w GOSUMDB=off
问题解决后建议重新开启以保障安全。
检查模块版本与网络连通性
模块不存在或版本写错也会导致“下载失败”。确认 go.mod 中依赖的模块路径和版本号正确。
例如：
require github.com/gin-gonic/gin v1.9.1
可通过浏览器访问对应模块页面验证是否存在。同时测试网络是否可达：
curl -I https://goproxy.cn/github.com/gin-gonic/gin/@v/v1.9.1.info
返回 200 表示代理可正常响应。
基本上就这些。合理配置代理、排除私有模块、清理缓存、验证版本信息，大多数下载问题都能快速定位解决。不复杂但容易忽略细节。
