配置 GOPROXY 可解决 Go 项目第三方包下载慢、超时等问题，推荐国内使用 https://goproxy.cn,direct，配合 GOPRIVATE 处理私有仓库，缓存默认启用且受 go.sum 校验保护。
在 Go 项目中，第三方包下载慢、超时或失败是常见问题，尤其在国内网络环境下。通过配置 Go proxy（代理）可显著提升模块下载速度、稳定性和可复现性，同时还能实现本地缓存复用，避免重复拉取。
设置 GOPROXY 环境变量
Go 1.13+ 默认启用模块代理机制，只需正确配置 GOPROXY 即可生效。推荐使用国内可靠的公共代理服务：
-
官方推荐组合：
https://proxy.golang.org,direct（海外用户） -
国内推荐组合：
https://goproxy.cn,direct或https://goproxy.io,direct -
多级 fallback 写法：
https://goproxy.cn,https://goproxy.io,https://proxy.golang.org,direct
执行命令永久生效（以 Linux/macOS 为例）：
echo "export GOPROXY=https://goproxy.cn,direct" >> ~/.bashrc && source ~/.bashrc
立即学习“go语言免费学习笔记（深入）”；
Windows 用户可在系统环境变量中添加 GOPROXY，值为 https://goproxy.cn,direct。
启用私有代理与本地缓存（Go 1.18+）
若团队有内网环境或需长期稳定缓存，可部署私有 Go proxy 服务，如 athens 或 goproxy（Go 实现）。更轻量的方式是启用 Go 自带的 go mod cache 优化：
- Go 默认已将所有下载的模块缓存在
$GOPATH/pkg/mod/cache，无需额外配置 - 可通过
go clean -modcache清理旧缓存，释放磁盘空间 - 使用
go mod download -x查看实际下载路径和代理行为
注意：缓存内容受 go.sum 校验保护，即使走代理也不会破坏依赖完整性。
跳过校验与私有仓库支持
当使用公司内部 Git 仓库（如 GitLab、Gitee）托管私有模块时，需配合 GONOPROXY 和 GOPRIVATE：
-
GOPRIVATE=git.example.com,github.company.com：匹配域名的模块不走 proxy，直连获取 -
GONOPROXY=git.example.com：同上，但仅控制 proxy 行为（GOPRIVATE更推荐） - 多个域名用逗号分隔，支持通配符如
*.example.com
建议统一设置：
export GOPRIVATE="git.example.com,*.gitee.com"
验证与调试技巧
确认代理是否生效，可运行以下命令观察行为：
-
go env GOPROXY：查看当前 proxy 配置 -
go list -m -u all：触发模块检查，观察是否快速返回 -
go mod download -x github.com/spf13/cobra@v1.8.0：加-x显示详细 HTTP 请求过程 - 临时禁用 proxy 测试：
GOPROXY=off go build
若仍出现 timeout 或 403，检查是否被防火墙拦截，或尝试更换代理地址（如从 goproxy.cn 换成 goproxy.io）。