为什么 GOPROXY 是解决 SDK 下载慢的唯一靠谱办法
Go 官方 SDK（比如 google.golang.org/api、cloud.google.com/go）本质是普通 Go 模块，不是独立安装包。它走的是 go mod download 流程，而默认代理 https://proxy.golang.org 在国内直连基本超时或 403。不配 GOPROXY，就等于让所有模块请求都卡在海外 CDN 和防火墙之间。
这不是网络问题，是设计使然：Go Modules 的代理机制本就依赖可配置的镜像源，官方也明确推荐用 GOPROXY 解决区域访问问题。
-
GOPROXY不是“加速插件”，而是 Go 原生支持的模块分发通道，生效后go get、go mod tidy全部自动走镜像 - 别试
git clone手动替换 —— SDK 版本多、依赖嵌套深，手动维护会立即崩在go.sum校验上 - 也不用装任何客户端或代理工具，纯环境变量即可，改完终端重开就生效
该设成什么值？https://goproxy.cn,direct 是当前最稳组合
截至 2026 年初，https://goproxy.cn（七牛云）仍是国内响应最快、缓存最全、校验最可靠的公共 Go 代理。它完整支持 HTTPS、透明转发 go.sum、自动处理重定向，且对私有模块兼容性好。
关键在于末尾的 ,direct —— 它不是可选项，而是兜底安全机制：
立即学习“go语言免费学习笔记（深入）”；
- 当遇到
GOPRIVATE里声明的私有域名（如git.internal.company），Go 会跳过代理，直连拉取，避免鉴权失败或泄露 - 如果某个模块在镜像中暂未缓存（极少见），
direct会 fallback 到原始源，而不是报错中断 - 别写成
https://goproxy.cn/（带斜杠结尾）—— Go 会解析失败，返回invalid proxy URL
执行这条命令永久生效：go env -w GOPROXY=https://goproxy.cn,direct
哪些情况必须配 GOPRIVATE，否则 SDK 下载直接失败
很多团队用 GCP 或 AWS SDK 时还混着公司内部封装库（比如 github.com/your-org/cloud-utils），一旦这些私有模块被 GOPROXY 拦截，就会出现：verifying github.com/your-org/cloud-utils@v0.1.0: github.com/your-org/cloud-utils@v0.1.0: reading https://goproxy.cn/github.com/your-org/cloud-utils/@v/v0.1.0.info: 404 Not Found
这不是镜像没同步，是代理压根不该碰你内网地址。必须显式告诉 Go 哪些模块绕过代理：
- 按域名匹配：
go env -w GOPRIVATE=git.internal.company,github.com/your-org - 支持通配符：
go env -w GOPRIVATE=*.company.com,bitbucket.org/our-team - 多个用英文逗号分隔，**不能有空格**，否则 Go 会当成单个无效域名
- 设置后，
go mod download对匹配模块会改用git clone或 HTTPS Basic Auth 直连，读取 ~/.netrc 或 Git 凭据管理器
验证是否真生效？别只看 go env，要盯日志输出
go env GOPROXY 只能确认变量写对了，不代表实际请求走代理。真正判断方式是触发一次模块下载，并观察 HTTP 请求路径：
- 运行：
go mod download -x google.golang.org/api@v0.175.0 - 如果看到类似
Fetching https://goproxy.cn/google.golang.org/api/@v/v0.175.0.info，说明代理已命中 - 如果看到
Fetching https://api.github.com/repos/googleapis/google-api-go-client/commits/...，说明被GOPRIVATE或GONOPROXY拦截了，或者GOPROXY格式错误 - 若仍卡住或报
timeout，检查终端是否被 Clash/V2Ray 等工具劫持了 HTTPS 流量（它们可能干扰 Go 的 TLS 握手）
最容易被忽略的一点：Windows 用户用 PowerShell 设置后，得关掉旧终端再开新窗口；WSL 用户要确认是改了 WSL 里的 ~/.bashrc 还是 Windows 的系统变量 —— 两者互不影响。
