go mod download卡在dial tcp或context deadline exceeded是go cli连接proxy.golang.org被阻断所致；需用go mod download -v定位卡点，手动curl验证dns/tls/连通性，设goproxy=https://goproxy.cn,direct并配goprivate支持私有模块。
go mod download 卡在 dial tcp 或 context deadline exceeded
这不是代码写错了，是 Go CLI 在尝试连接 proxy.golang.org 时被防火墙或 DNS 污染阻断。典型现象是执行 go mod download 后几秒没反应，Ctrl+C 也无效，等几十秒才报错。
快速验证：运行 go mod download -v，看最后卡在哪条 URL；再复制那条 curl 命令手动执行，就能区分是 DNS 解析失败、TLS 握手超时，还是纯粹连不上。
- 若
curl https://proxy.golang.org直接 timeout，说明默认代理不可达，必须换国内镜像 - 若
curl成功但go mod仍失败，检查是否漏了,direct—— 比如只设GOPROXY=https://goproxy.cn会导致私有模块拉取 403 - 企业内网常见问题：Go 默认用纯 Go DNS 解析器，有时比系统 DNS 更慢或失败；可临时加
go env -w GODEBUG=netdns=cgo切回系统 DNS
GOPROXY 设置后仍 403 或 module lookup failed
403 错误基本等于你引用了私有仓库（比如 gitlab.internal.com），但没告诉 Go “别走代理”，它把请求转发给了 goproxy.cn，而镜像站当然没权限访问你的内网地址。
解决关键是配对 GOPROXY 和 GOPRIVATE：
-
go env -w GOPROXY=https://goproxy.cn,direct（注意逗号后不能有空格） -
go env -w GOPRIVATE="gitlab.internal.com,github.com/my-org/*"（支持通配符，多个域名用逗号分隔） - 如果私有域名含端口（如
gitlab.internal.com:8080），必须完整写入GOPRIVATE，否则仍会走代理 - 验证：运行
go env GOPRIVATE，输出应严格匹配你设的值，无额外空格或引号
go install gopls / dlv 等工具时超时
go get 在 Go 1.16+ 已不推荐，它会绕过 GOPROXY 直连 golang.org，而该域名在国内几乎必挂。
改用 go install 并确保模块模式开启：
- 先确认：
go env GO111MODULE输出应为on；如果不是，执行go env -w GO111MODULE=on - 安装命令：例如
GO111MODULE=on go install golang.org/x/tools/gopls@latest - 如果仍失败，检查
GOPRIVATE是否覆盖了工具依赖里的私有路径（比如某些定制版gopls依赖内部包） - 极少数情况：工具源码里硬编码了
golang.org/x/...路径，可临时替换为github.com/golang/...，但需同步改 import，仅作调试用
本地自建 GOPROXY（如 Athens）无法连接
自建服务起不来，90% 是监听地址或网络策略问题，不是配置写错。
重点排查：
- 服务是否监听
0.0.0.0:3000而非127.0.0.1:3000？Docker 容器或 WSL 中，localhost不等于宿主机的127.0.0.1 - 防火墙是否放行端口？Linux 上运行
sudo ufw status或iptables -L；macOS 检查“防火墙选项”中是否允许该进程入站 - Go CLI 能否访问该地址？执行
curl -v http://localhost:3000，成功后再试GOPROXY=http://localhost:3000 go mod download - 不要忽略证书：若用 HTTPS 自签证书，需加
go env -w GOSUMDB=off（仅限开发环境）或配置可信 CA
最易被忽略的是 GOPRIVATE 和 ,direct 的组合逻辑——少一个逗号、多一个空格、漏掉某个子域名，都会让私有模块悄悄走代理然后 403。调完记得 go clean -modcache 清缓存再试。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
