go模块下载被拦截需换国内代理，推荐设全局goproxy=https://goproxy.cn,direct并清缓存go clean -modcache，私有模块应置于direct前且配置git url重写。
Go 模块下载被拦截，本质是 go mod download 默认走官方 proxy.golang.org 和 sum.golang.org，国内直连基本不可用。换源是唯一稳定解法，不是权宜之计，而是必须步骤。
怎么快速切换到可信的国内代理
Go 1.13+ 支持 GOPROXY 环境变量，优先级高于 go env -w 配置，推荐直接设为全局环境变量（避免每次进项目重配）：
- Linux/macOS：在
~/.bashrc或~/.zshrc中添加export GOPROXY=https://goproxy.cn,direct - Windows（PowerShell）：
[Environment]::SetEnvironmentVariable("GOPROXY", "https://goproxy.cn,direct", "User") - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct
注意末尾的 direct ——它表示当代理无法提供某模块时，自动回退到直接拉取（比如私有仓库），不加会导致私有模块失败。
为什么不能只用 go env -w GOPROXY=...
go env -w 写入的是 GOENV 文件（默认 $HOME/go/env），但某些 CI 环境、Docker 构建或 IDE 启动的终端可能未加载该配置，导致行为不一致。更严重的是：如果之前执行过 go mod download 且缓存了失败记录（如 403/timeout），即使改了 GOPROXY，go 仍可能复用本地失败缓存，表现为“改了也不生效”。
- 解决办法：改完代理后务必清缓存：
go clean -modcache - 再试一次：
go mod download，观察日志中是否出现goproxy.cn域名请求
遇到 checksum mismatch 错误怎么办
这是最典型的“换源后报错”，原因不是代理问题，而是本地 go.sum 记录的是旧校验值（来自 proxy.golang.org 或 direct 拉取），而新代理返回的模块内容哈希不一致——常见于模块作者重推 tag 或镜像同步延迟。
- 先确认是否真为误报：访问
https://goproxy.cn/github.com/user/repo/@v/v1.2.3.info查看该版本真实Sum字段，和go.sum里对应行对比 - 若确认代理返回正确，可安全更新：
go mod download -dirty（跳过校验）或go mod verify后手动修正go.sum - 更稳妥做法：
rm go.sum && go mod tidy，让工具重新生成（前提是go.mod版本约束明确）
私有模块（如 GitLab、自建 Nexus）怎么共存
GOPROXY 的逗号分隔机制天然支持多级代理，但顺序很重要：
- 写成
https://goproxy.cn,https://proxy.golang.org,direct是错的——一旦 goproxy.cn 返回 404（比如私有模块），就会继续问 proxy.golang.org，后者照样失败 - 正确写法：
https://goproxy.cn,https://your-private-proxy.example.com,direct，把私有代理放在direct前，且确保其能处理内部域名（如gitlab.internal/pkg） - 若私有模块用 SSH 地址（
git@gitlab.com:org/repo.git），需额外配置git config --global url."https://gitlab.com/".insteadOf "git@gitlab.com:"，否则go无法走 HTTP 代理
代理链越长，失败路径越隐蔽；建议生产环境只保留一个可信代理 + direct，私有模块单独用 replace 或 go.mod 中显式 require 版本加 // indirect 注释来隔离。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
