该错误本质是 Git 问题而非 Go 问题，因 Go 在后台调用 git clone 或 git ls-remote 失败所致，常见原因包括：git 版本过低、私有仓库未配置 GOPRIVATE、Git 认证或协议配置不当。
go mod download 报 unknown revision 是 Git 问题，不是 Go 问题
这个错误表面是 Go 找不到版本，实际是 git 命令拉不到代码——Go 在背后调用 git clone 或 git ls-remote，一旦失败就包装成 “unknown revision”。常见原因有三个：git 版本太低（GOPRIVATE。
验证方式很简单：手动执行 Go 日志里最后一行显示的 git 命令（比如 git -c core.autocrlf=false ls-remote -f https://gitlab.example.com/my/repo.git），看是否返回 tag/commit 列表。如果报 Permission denied (publickey) 或 fatal: unable to access，那就跟 Go 无关了。
- 升级
git到 2.20+（旧版不支持某些 refspec 语法） - 如果是 SSH 地址（
git@gitlab.example.com:my/repo），确认~/.ssh/id_rsa已添加到 ssh-agent，且ssh -T git@gitlab.example.com能通 - 如果是 HTTPS 地址但需要账号密码，运行
git config --global credential.helper store，然后手动git clone一次输凭据
GOPROXY=direct 仍卡住，说明问题出在 Git 协议或 DNS
设了 GOPROXY=direct go mod download -v 还卡住，基本可排除代理配置问题，重点查两点：DNS 是否能解析私有域名、Git 是否被防火墙拦截。
go mod download -v 输出的最后一行通常是类似 git -c core.autocrlf=false clone --mirror --single-branch --no-local --reference-if-able ... 的命令。复制它，在终端里直接运行，观察卡在哪一步：
立即学习“go语言免费学习笔记（深入）”；
- 卡在
Resolving deltas→ 网络带宽或 Git 服务器响应慢，不是配置问题 - 卡在
Cloning into bare repository→ DNS 解析失败，用nslookup gitlab.example.com验证 - 卡在
fatal: unable to access 'https://...': Failed to connect to gitlab.example.com port 443→ 防火墙拦截或 TLS 证书异常，尝试curl -I https://gitlab.example.com
checksum mismatch 不要删 go.sum，先确认是不是缓存污染
报 checksum mismatch 时，第一反应不是删 go.sum，而是检查本地模块缓存是否混入了被篡改或不完整的内容。Go 默认把下载的包存在 $GOPATH/pkg/mod/cache/download，如果中途断网或磁盘写入异常，可能留下损坏的 zip。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
安全做法是只清理对应模块的缓存项：
- 运行
go clean -modcache清掉全部（适合本地开发环境） - 或者更精准：找到报错模块路径（如
github.com/google/flatbuffers），进$GOPATH/pkg/mod/cache/download/github.com/google/flatbuffers，删掉里面所有.zip和.info文件 - 再跑
go mod download -v，让 Go 重新拉取并校验
注意：如果团队共用 CI 缓存，得同步清理共享缓存目录，否则下次构建还会复现。
go get 报 unrecognized import path，本质是 GOPROXY 没生效或模块路径拼错
比如 go get golang.org/x/net 报 unrecognized import path "golang.org/x/net"，99% 是 GOPROXY 没生效，而不是模块不存在。
先执行 go env GOPROXY，输出必须是非空且含国内镜像地址（如 https://mirrors.tuna.tsinghua.edu.cn/go/modules/）。如果输出是空或仍是 https://proxy.golang.org,direct，说明设置没生效：
- Linux/macOS：检查是否用了
go env -w（推荐），而不是只改 shell profile 但没source - Windows：PowerShell 用
$env:GOPROXY="https://goproxy.cn"只对当前会话有效；永久设置要用go env -w GOPROXY=... - IDE（如 Goland）：单独配置 GOPROXY，不能只依赖系统环境变量
另外检查 import 语句里的路径是否拼错——Go 不会自动补全或纠错，golang.org/x/net/http2 写成 golang.org/x/net/http2/（末尾斜杠）就会报这个错。
