超时可通过错误信息“context deadline exceeded”或“dial tcp: i/o timeout”确认；非超时卡顿可能源于dns慢、tls失败或私有模块误代理；需用go mod download -v定位卡点，配合dig/telnet分离网络层问题；goproxy必须含,direct且gonoproxy显式排除私有域；gopls安装失败多因绕过代理直连golang.org；go run长时间卡住是cli底层net.dial无timeout所致，可用godebug=netdns=cgo缓解。
go mod download 卡在 Fetching 阶段怎么确认是超时？
直接看错误信息最准：context deadline exceeded 或 Get "https://proxy.golang.org/...": dial tcp: i/o timeout 就是典型超时。不是所有“卡住”都叫超时——也可能是 DNS 解析慢、TLS 握手失败，或私有模块被误代理。
实操建议：
- 加
-v参数运行：go mod download -v，观察最后一条 curl 命令卡在哪一步（DNS / connect / TLS / response） - 手动执行那条 curl（去掉
-v和--fail），加-w '%{http_code}\n'和-o /dev/null，看是 000（无响应）还是 404/503（代理返回） - 用
dig proxy.golang.org和telnet proxy.golang.org 443分离 DNS 和 TCP 层问题
GOPROXY 设置后仍超时，,direct 忘了会怎样？
漏掉 ,direct 是国内最常见配置失误：设成 GOPROXY=https://goproxy.cn 后，所有模块（包括 gitlab.example.com/internal/pkg 这类私有路径）都会走镜像站，而镜像站根本拉不到内网地址，最终 fallback 失败，表现为超时而非 404。
实操建议：
- 必须用逗号拼接：
go env -w GOPROXY=https://goproxy.cn,direct - 私有域名要显式排除：
go env -w GONOPROXY="gitlab.example.com,192.168.0.0/16"，否则direct不生效 - 验证方式：
go env GOPROXY输出应含,direct；go env GONOPROXY应匹配你的真实内网范围
go install gopls@latest 超时，是不是 GOPROXY 没起作用？
不是。go get 和 go install（Go 1.16+）对 golang.org/x/... 路径有特殊逻辑：即使设置了 GOPROXY，部分工具仍会绕过代理直连 golang.org，而该域名在国内基本不可达。
实操建议：
- 弃用
go get，改用：GO111MODULE=on go install golang.org/x/tools/gopls@latest - 若仍失败，临时替换路径：
go install github.com/golang/tools/gopls@latest（注意 import 语句也要同步改，仅调试用） - 根本解法：确保
GOPROXY可达 +GONOPROXY正确排除私有域，再重试
go run 卡住十几秒才报错，Ctrl+C 不响应，是代码问题吗？
不是代码问题，是 Go CLI 自身行为：底层 net.Dial 在 DNS 解析或 TCP 建连阶段未设 timeout，遇到丢包或慢 DNS 会阻塞到底，且不响应中断信号。pprof 显示 goroutine 停在 net.(*pollDesc).wait 就是这个症状。
实操建议：
- 临时缓解：
go env -w GODEBUG=netdns=cgo强制用系统 DNS 解析器（避开 Go 纯 Go DNS 实现的 bug） - 验证是否 DNS 问题：
go mod download -x查最后 curl，复制出来加-v看卡在 resolving 还是 connecting - 长期方案：企业内网部署 Athens 类私有 proxy，彻底切断对外依赖；或确保
GOPROXY地址可稳定访问（监听0.0.0.0:3000，非127.0.0.1）
Timeout() 当成一回事。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
