go mod download卡在dial tcp或context deadline exceeded是防火墙阻断所致，需同时设goproxy=https://goproxy.cn,direct和gosumdb=off，并配置goprivate以支持私有仓库。
go mod download 卡在 dial tcp 或 context deadline exceeded
这是最典型的防火墙阻断表现：命令无响应、长时间等待后报错，或直接显示 dial tcp: i/o timeout、context deadline exceeded。根本不是模块不存在，而是 Go 工具链在发起 HTTPS 请求时被中间网关静默丢包或重置连接。
实操建议：
- 立即执行
go env -w GOPROXY=https://goproxy.cn,direct（direct不可省，否则私有模块会 403） - 运行
go env GOPROXY确认输出为https://goproxy.cn,direct，不是空值或https://proxy.golang.org - 若仍失败，加
-v参数看卡在哪一步：go mod download -v，最后一行通常是curl -sS命令，复制出来手动执行，确认是 DNS、connect 还是 TLS 阶段失败 - 企业内网常见 DNS 污染，可临时强制系统 DNS 解析：
go env -w GODEBUG=netdns=cgo
GOPROXY=off 后 go mod verify 或 go list -m all 仍失败
只关 GOPROXY 不够。Go 在解析依赖树或校验完整性时，默认还会访问 sum.golang.org——这个地址同样被阻断，导致 go mod verify、go list -m all 甚至 go build 都可能卡住或报 verifying ...: checksum mismatch。
实操建议：
- 必须同时关闭校验服务：
go env -w GOSUMDB=off - 验证是否生效：
go env GOPROXY GOSUMDB应输出off off - 注意：关闭
GOSUMDB后，所有模块校验跳过，依赖安全性完全由你本地缓存来源决定；离线环境务必确保$GOMODCACHE来自可信机器 - 若局域网部署了内部 sumdb（如 Athens 配合 sumdb proxy），可设为
GOSUMDB=sum.golang.org+http://intranet-proxy:8080/sumdb，而非直接关掉
golang.org/x/ 工具类模块（如 gopls、dlv）始终拉不到
go get golang.org/x/tools/gopls@latest 类命令容易失败，并非代理问题，而是 Go 1.16+ 后 go get 对 golang.org/x/ 路径有特殊逻辑：部分子命令会绕过 GOPROXY，直连 golang.org —— 该域名在国内基本不可达。
实操建议：
- 改用
go install（推荐方式）：GO111MODULE=on go install golang.org/x/tools/gopls@latest - 若仍超时，检查
GOBIN是否被设为异常路径（如写入了权限受限目录），可先清空：go env -u GOBIN - 不建议手动 clone 到
$GOPATH/src：Go Modules 模式下该路径已废弃，且go install不读取它 - VS Code 提示 “gopls not installed” 时，别点弹窗自动安装——打开命令面板，输入
Go: Install/Update Tools全选安装更可靠
私有 Git 仓库（GitLab/GitHub Enterprise）拉取 403 或 authentication required
即使配了 GOPROXY=https://goproxy.cn,direct，只要模块路径没被 GOPRIVATE 覆盖，Go 仍会把请求发给代理，结果返回 403（代理无权访问内网地址）或 unknown revision（代理查不到私有分支）。
实操建议：
- 把私有域名加入
GOPRIVATE：go env -w GOPRIVATE="gitlab.example.com,github.mycompany.com"（逗号分隔，无空格，支持通配符如*.mycorp.com） - HTTPS 私有库需 Git 凭证持久化：
git config --global credential.helper store，然后手动git clone https://gitlab.example.com/group/repo输一次账号密码 - SSH 方式更稳定：确保
~/.ssh/id_rsa已添加到 Git 平台，且go.mod中模块路径为git@gitlab.example.com:group/repo格式 - 用
go mod download -v观察最后是否出现git clone命令——卡在这步，基本就是 SSH key 或~/.ssh/configHost 别名没配对
真正麻烦的从来不是配对一个变量，而是多个网络控制点（GOPROXY、GOSUMDB、GOPRIVATE）之间的协同失效。最容易被忽略的是：哪怕只漏掉 ,direct 或少关一个 GOSUMDB，整个流程就可能在某个看似无关的命令里突然中断。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
