配置 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

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）。