go mod下载卡在sum.golang.org超时，根本原因是gosumdb默认值未适配国内网络，必须显式设为sum.golang.google.cn或off；即使goproxy已配置，gosumdb仍独立直连校验，失败即中断流程。
go mod 下载卡在 sum.golang.org 连接超时
这是国内 Go 开发者最常遇到的阻塞点：执行 go mod download 或 go run 时，终端卡住几秒后报错 dial tcp 142.251.42.241:443: connectex: A connection attempt failed。这个 IP 是 sum.golang.org 的地址，说明问题不在代码或 go.mod，而在模块校验环节被网络拦截。
根本原因是 Go 默认启用校验和数据库（GOSUMDB），且默认值就是海外的 sum.golang.org。即使你已配置了 GOPROXY=https://goproxy.cn,direct，只要 GOSUMDB 没同步调整，go 命令仍会尝试直连它完成校验，失败即中断整个流程。
-
GOSUMDB必须显式设置，不能依赖GOPROXY自动代理 —— 它是独立开关 - 设为
off最快但放弃安全校验，仅适合离线开发或可信内网环境 - 推荐设为
sum.golang.google.cn（官方中国镜像），它与goproxy.cn协同工作，校验通过率高、响应稳定 - 若用阿里云镜像
https://mirrors.aliyun.com/goproxy/，则必须配GOSUMDB=off，因其不提供校验服务
VSCode 中 gopls 报 “no required module provides package”
你在编辑器里写 import "github.com/gin-gonic/gin"，但 hover 提示找不到包，Ctrl+Click 跳转失败，终端运行却正常 —— 这通常是 gopls（VSCode Go 插件的语言服务器）没读到你终端里生效的 GOSUMDB 值。
gopls 启动时只读取环境变量快照，不会动态监听变化。你改了 ~/.zshrc 或执行了 go env -w GOSUMDB=...，但 VSCode 没重启，它就还是用旧值去连 sum.golang.org，校验失败后直接拒绝加载模块。
- 必须重启
gopls：快捷键Cmd/Ctrl + Shift + P→ 输入Go: Restart Language Server - 确认 VSCode 是从 shell 启动的（macOS/Linux）或已继承系统环境变量（Windows）；否则它可能只看到空环境
- 检查当前工作区是否在
go.mod所在目录下，否则gopls会退化为 GOPATH 模式，忽略GOSUMDB - 不要禁用
go.useLanguageServer，那只会让错误更隐蔽，不是修复
GOPROXY 和 GOSUMDB 组合配置的常见陷阱
很多人以为只要 GOPROXY 设对了，GOSUMDB 就可以不管。实际上两者必须语义一致，否则会出现“下载成功但校验失败”或“校验通过但下载 404”等矛盾现象。
-
GOPROXY=https://goproxy.cn,direct+GOSUMDB=sum.golang.google.cn：黄金组合，国内最稳 -
GOPROXY=https://mirrors.aliyun.com/goproxy/+GOSUMDB=off：可行，但aliyun镜像不支持/@v/vX.Y.Z.info路由，某些工具（如旧版gopls）会报错 -
GOPROXY=direct（即关代理） +GOSUMDB=off：仅限完全离线或私有模块场景，公网模块会全部失败 - 误写
GOSUMDB=https://sum.golang.google.cn（带https://）：会触发 URL 解析错误，正确值是纯域名sum.golang.google.cn
验证 GOSUMDB 是否真正生效
别只看 go env 输出，要实测校验链路是否通。最直接的方法是手动触发一次校验请求：
运行 go mod download -json github.com/spf13/cobra@v1.8.0，观察输出中是否有 "SumDB":"sum.golang.google.cn" 字段；再执行 go list -m -json all | head -n 10，确认没有 sum.golang.org 相关错误日志。
- 如果仍看到
verifying github.com/xxx@vX.Y.Z: checksum mismatch，说明本地go.sum里存的是旧校验值，需运行go mod tidy -v强制刷新 - 若
go env GOSUMDB显示为空，说明未设置，go会回退到默认值sum.golang.org - Windows 用户注意：PowerShell 中用
$env:GOSUMDB="sum.golang.google.cn"是临时设置，永久生效必须用go env -w GOSUMDB=...或系统环境变量面板
GOSUMDB 不是“开/关”二选一，而是校验源的路由选择。一旦选错，go 工具链会在下载后多走一步不可见的 HTTP 请求，而这一步在国内几乎必然失败 —— 它不像 GOPROXY 那样有 fallback 机制，失败即终止。
