go cli底层net.dial无超时导致卡顿，根本解法是配置goproxy=https://goproxy.cn,direct并确保direct存在，避免私有模块拉取失败；临时缓解可用godebug=netdns=cgo切换dns解析器。
go mod download 卡在 dial tcp 或 context deadline exceeded
这不是代码写错了，是 Go CLI 在底层 net.Dial 阶段没设 timeout，遇到 DNS 解析慢、中间网关丢包或服务器响应延迟时，会卡住几十秒甚至更久，且 Ctrl+C 无效。现象常表现为：Get "https://proxy.golang.org/": dial tcp: i/o timeout 或 context deadline exceeded。
验证方法：运行 go mod download -x，看最后一条 curl 命令；复制出来手动执行，就能区分是 DNS、connect 还是 TLS 阶段慢。
- 临时缓解：加
go env -w GODEBUG=netdns=cgo，强制用系统 DNS，避开 Go 自带纯 Go DNS 解析器（有时更慢） - 根本解法：确保
GOPROXY指向的地址可达——优先选https://goproxy.cn,direct，它对新版 Go 和校验兼容性更稳 - 若用自建 proxy（如 Athens），必须监听
0.0.0.0:3000而非127.0.0.1:3000，尤其在 Docker 或 WSL 环境下
GOPROXY 设置漏掉 direct 导致私有模块拉取失败
只设 GOPROXY=https://goproxy.cn 是常见错误。Go 会完全走代理，一旦遇到公司内网 GitLab、Git 仓库或 example.com/internal 这类私有域名，就返回 404 或 403，而不是 fallback 到直连。
direct 不是可选项，是兜底机制：当代理返回 404/403 时，Go 才会尝试直连源站。没有它，私有模块根本拉不下来。
- 正确写法必须是
https://goproxy.cn,direct（逗号分隔，direct在末尾） - 若还需跳过某些域名的代理和校验，要同步配
GONOPROXY和GONOSUMDB，值必须完全一致，例如：go env -w GONOPROXY="git.internal.company.com"+go env -w GONOSUMDB="git.internal.company.com" - 通配符不支持路径，只匹配子域名，
*.corp.company可行，corp.company/internal不行
go mod tidy 因 checksum 校验卡住
真正拖慢 go mod tidy 的往往不是下载本身，而是后续的校验阶段：verifying github.com/xxx@v1.2.3 这一步会去 sum.golang.org 查 checksum，而该域名在国内基本不可达，导致反复重试、超时。
这时 direct 就成了关键保险——它让 Go 在代理失败后直连源站，并跳过远程校验（前提是本地已有 go.sum 条目或已缓存）。
- 不要全局关校验（如
GOSUMDB=off），开发环境可接受，但 CI/发布环境风险高 - 更稳妥的做法是保留校验逻辑，但换源：
go env -w GOSUMDB=sum.golang.org+replace=gosum.io+ca=trusted（仅限可信内网） - 若只是临时调试，执行
go clean -modcache清掉旧缓存，再跑go mod tidy -v看具体卡在哪一行
VS Code 中 gopls 无法解析依赖
即使终端里 go mod download 成功了，VS Code 里的 gopls 仍报 no required module provides package，大概率是 IDE 没读到你 shell 里设的 GOPROXY。
VS Code Go 插件有自己的环境变量作用域，不会自动继承终端配置。它默认可能还在用 proxy.golang.org，所以 hover、跳转、补全全失效。
- 必须在 VS Code 用户设置里显式配置：
"go.toolsEnvVars": {"GOPROXY": "https://goproxy.cn,direct"} - 确认工作区根目录含
go.mod，否则 gopls 退化为 GOPATH 模式，无视模块代理 - 改完后重启语言服务：Cmd/Ctrl + Shift + P → 输入
Go: Restart Language Server - 别禁用
go.useLanguageServer，那只会掩盖问题，让编辑体验更差
direct 是否存在、GONOPROXY 是否与 GONOSUMDB 同步、以及 IDE 是否真正加载了这些变量——漏掉任一环，都可能让超时问题换个形式重现。
