根本原因是默认代理proxy.golang.org在国内不可达，导致dns污染或tls握手失败；应设goproxy=https://goproxy.cn,direct并验证生效，漏掉,direct会导致私有模块拉取失败。
go mod download 卡在 proxy.golang.org 超时
根本原因是默认代理 proxy.golang.org 在国内不可达，DNS 污染或 TLS 握手失败导致连接阻塞。这不是你本地网络差，而是 Go 工具链直连境外源的固有缺陷。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（注意必须带,direct） - 验证：运行
go env GOPROXY，输出应为https://goproxy.cn,direct - 若仍超时，加
-v参数看卡点：go mod download -v；如果最后停在GET https://goproxy.cn/...，说明镜像本身不可达，换https://mirrors.aliyun.com/goproxy/ - 漏掉
,direct会导致私有模块（如gitlab.example.com/internal）拉取失败——Go 会把所有域名都扔给代理，而镜像不支持私有路径
go install gopls 等工具时连接 golang.org/x 超时
go get 在 Go 1.16+ 已被弃用，它会绕过 GOPROXY 直连 golang.org，而该域名在国内基本无法解析。
- 改用
GO111MODULE=on go install golang.org/x/tools/gopls@latest（go install尊重GOPROXY） - 若仍失败，临时替换路径：
go install github.com/golang/tools/gopls@latest，但需同步修改代码中所有import "golang.org/x/tools/..." - 企业内网建议配
GONOPROXY：执行go env -w GONOPROXY="gitlab.example.com,192.168.0.0/16"，避免私有域名被代理劫持
go run 或 go build 卡在 DNS 解析或 dial 阶段
这不是代码 bug，是 Go CLI 默认用纯 Go DNS 解析器 + 无 timeout 的 net.Dial，遇到丢包或慢 DNS 会阻塞几十秒且 Ctrl+C 无效。
- 快速定位：运行
go mod download -x，复制最后一条curl命令手动执行，看是 DNS 还是 connect 超时 - 临时缓解：执行
go env -w GODEBUG=netdns=cgo，强制走系统 DNS（libc resolver） - 根本解法：确保
GOPROXY地址可达；若自建 Athens 服务，检查是否监听0.0.0.0:3000（而非127.0.0.1:3000），尤其 Docker/WSL 场景下
HTTP 客户端请求超时配置失效
http.Client.Timeout 是个“总闸”，设了反而容易掩盖真实问题——它覆盖 Transport 层所有超时，且无法区分卡在 DNS、TCP 还是 TLS 阶段。
- 禁用
Timeout字段，设为0，把控制权交给http.Transport - 必须配置
DialContext：用&net.Dialer{Timeout: 3 * time.Second}控制 DNS+TCP 建连（net.DialTimeout已废弃） - HTTPS 必设
TLSHandshakeTimeout: 5 * time.Second；流式接口必设ResponseHeaderTimeout防服务端只发 header 就挂起 - 单次请求务必用
context.WithTimeout，构造http.NewRequestWithContext，否则超时逻辑不生效
真正卡住的往往不是代码里那行 conn.Read()，而是 go mod download 启动时那一次 DNS 查询，或是 http.Client 初始化时那个没设 Timeout 的 net.Dialer。这些地方不显眼，但一旦出问题，整个构建或请求链就断了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
