国内直接 go get 第三方包失败的核心原因是默认 GOPROXY=https://proxy.golang.org 在国内不可用；应配置为清华镜像+官方代理+direct 多级 fallback，私有模块还需配合 GONOSUMDB 和 GOINSECURE。
国内直接 go get 第三方包大概率失败，核心原因不是 Go 本身限制，而是模块代理（GOPROXY）默认值为 https://proxy.golang.org，该地址在国内无法稳定访问。
Go Proxy 是什么，为什么必须配
GOPROXY 是 Go 模块下载的中间代理服务，它缓存了所有公开模块的版本，并提供统一、可验证、带校验的下载入口。Go 1.13+ 默认启用模块代理机制，不配置或配置无效时，go mod download、go build、go test 等命令都会尝试走代理；若代理不可达，会 fallback 到直接 clone 源码仓库（如 GitHub），但很多仓库受网络限制或需要认证，导致失败或超时。
常见错误现象包括：
go: github.com/some/pkg@v1.2.3: Get "https://proxy.golang.org/...": dial tcp 216.239.37.1:443: i/o timeoutgo: module github.com/some/pkg: git ls-remote -q origin in /tmp/gopath/pkg/mod/cache/vcs/...: exit status 128: fatal: unable to access 'https://github.com/some/pkg/': Failed to connect to github.com port 443
推荐配置方式：环境变量 + 多级 fallback
最稳妥的做法是设置 GOPROXY 为多个 URL，用逗号分隔，Go 会按顺序尝试，直到成功或全部失败。国内主流选择是清华镜像 + 官方代理兜底：
立即学习“go语言免费学习笔记（深入）”；
export GOPROXY=https://mirrors.tuna.tsinghua.edu.cn/goproxy/,https://proxy.golang.org,direct
说明：
-
https://mirrors.tuna.tsinghua.edu.cn/goproxy/：响应快、同步及时、支持go list -m -json等元数据查询 -
https://proxy.golang.org：官方代理，作为二级 fallback（部分私有模块可能未被镜像收录） -
direct：表示最后 fallback 到直接拉取源码（仅限公开、可直连的仓库，比如你公司内网 GitLab 需单独配置GONOSUMDB和GOINSECURE）
注意：direct 必须小写，且不能加协议前缀；多个 proxy 之间用英文逗号分隔，**不能有空格**。
私有模块和公司内网场景怎么处理
如果项目依赖公司内部 Git 仓库（如 git.company.com/internal/pkg），仅靠 GOPROXY 不够，还需配合以下两个环境变量：
-
GONOSUMDB=git.company.com/internal/*：告诉 Go 不要对匹配路径的模块校验 checksum（因为私有库不在官方 checksum 数据库中） -
GOINSECURE=git.company.com：允许对 HTTP 协议的私有 Git 服务发起请求（绕过 TLS 强制要求）
这两个变量也支持通配符，但注意 GOINSECURE 只接受域名或 IP，不接受路径；GONOSUMDB 才支持路径前缀匹配。若同时使用 SSH 地址（如 git@git.company.com:internal/pkg.git），需确保本地已配置好 SSH key 并能正常 ssh -T 连通。
验证是否生效与常见坑点
配置完后，运行以下命令快速验证：
go env GOPROXY
输出应为预期值（不含空格、逗号分隔正确）。再执行：
go mod download github.com/spf13/cobra@v1.8.0
若无报错且在 pkg/mod/cache/download/ 下生成对应目录，即表示成功。
容易踩的坑：
- Windows 用户用 PowerShell 设置时，语法是
$env:GOPROXY="https://..."，不是set GOPROXY=...（cmd 旧语法在 PowerShell 中不生效） - IDE（如 Goland）可能不读取 shell 的环境变量，需在 IDE 设置里单独配置 Go toolchain 的环境变量
- 某些 CI 环境（如 GitHub Actions）默认不加载用户 profile，需在 workflow 中显式
env:设置 -
go clean -modcache后首次下载仍慢？这是正常现象——Go 会重新 fetch module index 和 checksum，不是代理失效
真正复杂的地方往往不在代理地址本身，而在于私有模块路径匹配规则、GOSUMDB 默认开启带来的校验拦截，以及不同终端/IDE/CI 对环境变量的加载差异。配完别急着跑，先 go env 看一眼，再 go mod download 试一个已知包。
