必须同时配置GOPROXY=https://goproxy.cn,direct、GOSUMDB=off（或可信镜像）及GONOPROXY豁免私有域名，缺一导致超时或校验失败；漏掉,direct会使私有模块404，不关GOSUMDB则go build仍连sum.golang.org超时。
go mod download 卡住、go build 报 context deadline exceeded 或 dial tcp: i/o timeout，不是 Go 本身有问题，而是模块下载阶段默认依赖境外代理且无 fallback 机制。国内弱网环境下，必须同时控制代理路径、校验行为和缓存策略，缺一不可。
为什么只设 GOPROXY 还会失败
常见误操作是只执行 go env -w GOPROXY=https://goproxy.cn，漏掉 ,direct 后缀。后果是私有模块（如 gitlab.internal.com/my/pkg）被强制走镜像站，而该站根本不存在这个路径，直接报 404 或超时。
-
GOPROXY必须写成https://goproxy.cn,direct：逗号分隔表示“优先走镜像，失败后直连源仓库” - 若项目含私有域名，还得加
GONOPROXY显式豁免，例如go env -w GONOPROXY="gitlab.example.com,192.168.0.0/16" -
GOPROXY=direct是临时调试用，长期使用会导致GOSUMDB仍尝试连sum.golang.org校验失败
GOSUMDB 不关，go build 一样挂
即使 go mod download 成功了，go build 阶段仍会去 sum.golang.org 校验 checksum——这是独立于 GOPROXY 的网络请求。弱网下它比模块下载更易超时，且错误信息藏得深（日志里只有一行 fetching sum.golang.org）。
- 测试环境直接关校验：
go env -w GOSUMDB=off - 生产环境需配可信校验源：
go env -w GOSUMDB=sum.golang.google.cn（阿里云镜像）或自建内网sum服务 - 别设
GOSUMDB=off后又用GOINSECURE，后者会跳过所有 HTTPS 证书校验，风险远高于关 checksum
弱网下频繁失败，先清缓存再重试
弱网常导致部分模块下载中断但残留脏缓存，后续 go mod download 会复用这些损坏的 zip 或 .info 文件，报 checksum mismatch 或 invalid version，实际跟网络无关。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 执行
go clean -modcache彻底清空$GOPATH/pkg/mod，再重试 - 避免在 CI 中反复
go mod vendor前不go mod tidy：残留的// indirect模块会让校验逻辑混乱 - CI 构建机建议固定组合：
GOPROXY=direct GOSUMDB=off go build，绕过所有远程请求
go install 工具链失败，别信 IDE 提示
VS Code 点 “Install All” 卡在 golang.org/x/tools/gopls，是因为 IDE 内部调用未继承 shell 的 GOPROXY 设置，且 go get 在 Go 1.16+ 已弃用，对工具链支持差。
立即学习“go语言免费学习笔记（深入）”；
- 手动运行：
GO111MODULE=on go install golang.org/x/tools/gopls@latest - 若仍卡住，加
-v看具体哪一步失败，大概率是golang.org/x/sys子模块——此时临时换源：git config --global url."https://gitee.com/golang-x/".insteadOf "https://golang.org/x/" - 安装完确认
$GOPATH/bin在PATH里，否则编辑器找不到gopls
go mod download -v 最后一行 curl 命令如果卡在 DNS 阶段，go env -w GODEBUG=netdns=cgo 强制用系统解析器，比换代理更直接。 
