go命令下载失败主因是网络代理或环境配置错误，需检查go111module是否为on、goproxy是否设为国内镜像（如清华源）、goprivate是否覆盖私有库、ssh/git凭证是否正确，并用go mod download -v逐层排查。
go 命令下载不了，基本不是 Go 本身坏了，而是网络、代理或环境配置没对上。国内用户十有八九卡在代理没设或设错了。
go get 报 “cannot find module providing package” 或直接卡住
这是最常见现象，本质是 Go 没法定位模块来源，通常因为：
- 当前目录没初始化模块：先运行
go mod init example.com/myapp，生成go.mod -
GO111MODULE实际没生效：执行go env GO111MODULE，输出必须是on；若为auto，且你在$GOPATH/src下操作，Go 会退回到老式 GOPATH 模式，拒绝下载模块 - 路径误入
$GOPATH/src：哪怕GO111MODULE=on，只要当前路径在$GOPATH/src内，Go 就强制走 legacy 模式——换到任意其他目录再试
GOPROXY 没配或配错导致 timeout / 403
Go 1.13+ 默认用 https://proxy.golang.org,direct，但这个地址在国内基本不可达。不改代理，go mod tidy 就会卡在 DNS 解析或 TLS 握手阶段。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 正确设置（推荐清华源）：
go env -w GOPROXY=https://mirrors.tuna.tsinghua.edu.cn/go/modules/,https://goproxy.cn,direct -
direct很关键：它让匹配GOPRIVATE的域名跳过代理直连，避免私有库 403 - 验证是否生效：
go env GOPROXY应输出你刚设的值，不是空或https://proxy.golang.org - 临时绕过代理调试：
GOPROXY=direct go mod download -v，看是否立刻失败（说明是网络问题），还是仍卡住（说明可能是 git 协议或认证问题）
私有模块拉取失败：403 / unknown revision / authentication required
公司 GitLab、GitHub 私有库、内网 Git 等，一旦路径没被 GOPRIVATE 覆盖，Go 就会把请求发给代理，结果返回 403 或 404。
- 加进
GOPRIVATE：go env -w GOPRIVATE="git.example.com,github.com/my-org/*"（注意逗号分隔、无空格、支持通配符） - HTTPS 私有库需 Git 凭证：运行
git config --global credential.helper store，然后手动git clone https://github.com/my-org/private-repo输一次账号密码，后续go调用会复用 - SSH 方式更稳：确保
~/.ssh/id_rsa已添加到对应平台，且go.mod中模块路径是git@github.com:my-org/private-repo格式 - 若仍失败，用
go mod download -v观察最后一行是否出现git -c core.autocrlf=false clone—— 卡在这里，基本是 SSH key 没配好或~/.ssh/configHost 别名不匹配
checksum mismatch / go.sum 冲突 / 缓存污染
不是下不了，而是校验失败后 Go 主动中止。常见于镜像源缓存陈旧、模块作者重推 tag、或本地 go.sum 和实际内容不一致。
- 先清理缓存：
go clean -modcache（注意：这会删掉所有已下载模块，下次要重下） - 临时关校验（仅调试）：
go env -w GOSUMDB=off；生产环境务必关掉，改用sum.golang.org并配好代理 - 若项目用了
vendor/，确保它完整：运行go mod vendor，且不要手动删vendor/后又不重新生成 - 错误里带
unknown revision？检查模块路径拼写、GitHub 用户名大小写、是否真发布了该 tag（git ls-remote origin可验证）
go 在不同阶段用了不同逻辑——模块发现走 GOPROXY，私有拉取走 git，校验走 GOSUMDB，缓存路径又依赖 GOMODCACHE。每个环节都可能断，得一层层用 -v 和 go env 对齐真实行为，而不是凭感觉改配置。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
