国内 go 开发者必须设置 goproxy 为国内镜像（如 https://goproxy.cn）并保留 ,direct 后缀，否则 go mod tidy 易卡死或校验失败；还需配合 goprivate 排除私有模块，且需清理 modcache 和 ide 缓存以确保生效。
国内 Go 开发者不配 GOPROXY 就别想顺利跑通 go mod tidy —— 不是慢，是大概率卡死或校验失败。
为什么 go mod download 总是 timeout 或 checksum mismatch
根本原因不是网络差，而是默认代理 https://proxy.golang.org,direct 在国内基本不可用：golang.org/x/ 等模块域名无法解析，go.sum 校验时拉不到元数据，导致看似“版本存在”实则“包内容缺失”。常见现象包括：
-
verifying github.com/xxx@v1.2.3: checksum mismatch（实际是代理返回了空响应或缓存脏数据） -
failed to fetch https://proxy.golang.org/xxx/@v/v1.2.3.info（直连超时） -
module golang.org/x/net@latest found (v0.28.0), but does not contain package golang.org/x/net/http2（元数据拉取失败，版本号存在但包结构错误）
如何用 go env -w 正确设置国内公共代理
推荐直接执行这条命令，覆盖全局配置：
go env -w GOPROXY=https://goproxy.cn,direct
关键点在于末尾的 ,direct —— 它不是可选项，而是必须项。它的作用是：当代理返回 404（比如私有模块、未缓存的新版本），Go 会自动 fallback 到直连模式，避免整个依赖链中断。其他可用地址包括：
-
https://mirrors.tuna.tsinghua.edu.cn/go/modules/（清华源，高校用户稳定） -
https://goproxy.io（老牌，对私有模块支持更灵活） -
https://mirrors.aliyun.com/goproxy/（阿里云，企业级 SLA）
多代理 fallback 写法也有效，但顺序不能错：
go env -w GOPROXY="https://goproxy.cn,https://proxy.golang.org,direct"
错误写法：GOPROXY=direct,https://goproxy.cn —— 这会导致所有请求先直连，等超时后才走代理，反而更慢。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
切换代理后 go mod tidy 还卡住？检查这三件事
代理设对了，但命令仍卡住，大概率是以下某个环节没对：
- 没清模块缓存：
go clean -modcache后再试，旧缓存可能含损坏的.info或.zip文件 - IDE 缓存未刷新：VS Code / GoLand 可能读取自身缓存，重启编辑器或手动触发 “Reload Modules”
- 私有模块没排除：如果项目引用了
git.mycompany.com/internal/utils，只设GOPROXY不够，必须加go env -w GOPRIVATE=git.mycompany.com，否则 Go 会把私有域名也发给代理，返回 403 或 404
验证是否生效最简单的方法：go env GOPROXY 输出应与你设置的一致；再执行 go get -v github.com/spf13/cobra@latest，观察日志里是否出现 Fetching https://goproxy.cn/github.com/spf13/cobra/@v/v1.12.0.info 这类路径。
GOPROXY=off 和 GOPROXY=direct 的区别在哪
这两个值常被混淆，但行为完全不同：
-
GOPROXY=off：完全禁用模块代理机制，所有模块都走 direct，且跳过go.sum校验（危险！易引入恶意包） -
GOPROXY=direct：仍是启用代理模式，只是把“代理列表”设为仅direct，它仍会查go.sum、走校验流程，只是不经过中间服务器
调试时建议用临时环境变量方式：GOPROXY=direct go mod download -v，而不是永久设为 off。真正要绕过代理又保校验，就用 direct；要彻底关掉代理机制（如离线构建），才用 off。
最易被忽略的是 ,direct 的位置和 GOPRIVATE 的配合——代理不是设完就一劳永逸，它和私有域声明是绑定动作。漏掉任意一个，都可能让 go mod tidy 在某个间接依赖上突然失败，而错误信息里完全不提代理的事。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
