go mod download 卡在 proxy.golang.org 是因默认代理不可达导致的必然失败，需配置 GOPROXY 为多源列表（如 goproxy.cn,tsinghua,direct）并同步设置 GOSUMDB=off 或可信校验源。
go mod download 卡在 proxy.golang.org 是网络波动还是配置问题
不是网络波动，是默认代理不可达导致的必然失败。Go 1.13+ 默认用 https://proxy.golang.org，国内直连基本会卡住几秒后报 dial tcp: i/o timeout 或直接 hang 住。这不是“偶尔波动”，而是每次都会触发——只要没配对代理，就不可能成功。
验证方法：运行 go env -w GOPROXY=direct 后再试 go mod download。如果仍失败，说明连 GitHub、GitLab 等源码仓库也访问不了；如果成功了，那问题 100% 出在代理配置上。
-
GOPROXY必须设为逗号分隔的多源列表，且以direct结尾，例如：https://goproxy.cn,https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct - 单写一个镜像（如只写
https://goproxy.cn）遇到 404 就退出，不尝试下一个 -
direct不是“可选备胎”，而是让私有模块（如git.internal.company.com/mylib）能 fallback 到直连
GOSUMDB 校验失败导致构建中断的真正原因
即使 go mod download 成功了，go build 还可能失败，错误里藏着 verifying github.com/xxx@v1.2.3: checksum mismatch 或静默卡在 fetching sum.golang.org。这不是代码被篡改，而是校验服务本身不可达或缓存不一致。
根本矛盾在于：GOPROXY 控制代码下载，GOSUMDB 控制哈希校验，两者独立生效。只配前者，后者仍会试图访问境外 sum.golang.org。
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 测试环境直接关掉校验：
go env -w GOSUMDB=off - 生产环境若需保留校验，必须同步配可信源，比如：
go env -w GOSUMDB=https://goproxy.cn/sum（注意域名和GOPROXY一致） - 内网 CI 构建机必须同时设
GOPROXY=direct和GOSUMDB=off，否则 vendor 目录也救不了你 - 别信
GOINSECURE——它绕过所有 HTTPS 校验，风险不可控，仅限调试临时用
CI/CD 中依赖拉取失败的隐蔽陷阱
很多团队在 CI 脚本里加了 go mod vendor，以为“本地有了就不怕网络”，结果构建还是失败。这是因为 Go 默认仍会远程校验，vendor 只是缓存，不是隔离。
CI 流程中真正有效的组合是：
- 先执行
go mod tidy，确保go.mod和go.sum一致，避免残留已删模块 - 运行
go mod download -x查看实际请求路径，确认所有模块都命中代理地址 - 构建前显式设置：
GOPROXY=direct GOSUMDB=off go build（不要只设GOPROXY） - 私有模块要额外加
GONOPROXY=git.corp.example.com，否则会被代理误转发
go install gopls/dlv 等工具时超时怎么办
VS Code 提示安装 gopls 却卡在 golang.org/x/tools，不是 IDE 问题，而是 go get 默认不走 GOPROXY，尤其对 golang.org/x/ 子路径。
正确做法是绕过 IDE 提示，手动用 go install：
- 确认代理生效：
go env GOPROXY输出应含goproxy.cn - 用新命令安装：
go install golang.org/x/tools/gopls@latest - 若仍失败，加
-v参数看卡在哪一步，大概率是某个golang.org/x/xxx子模块 - 极个别情况可临时替换源：
git config --global url."https://gitee.com/golang-x/".insteadOf "https://golang.org/x/"（仅限调试，勿提交到项目）
最常被忽略的是：GOPROXY 配了，但 GOSUMDB 没关，工具安装过程一样会因校验失败中断——这两者必须同时处理，缺一不可。
