go mod download卡在proxy.golang.org主因是默认代理对国内节点未优化，应设goproxy=https://goproxy.cn,direct并export生效，同时配goprivate处理私有模块、gosumdb=off或可信校验源，并清缓存go clean -modcache。
go mod download卡在proxy.golang.org怎么办
不是你网络差，是默认代理proxy.golang.org对国内节点没做优化，DNS污染、TLS握手超时、连接重置都常见。它根本就不是为国内直连设计的。
实操建议：
- 立刻设环境变量：
export GOPROXY=https://goproxy.cn,direct（注意逗号分隔，direct不能少） - 别只用
go env -w GOPROXY=...——Shell新开进程不继承，终端里必须export才真正生效 - 验证是否起作用：运行
go mod download -x github.com/spf13/cobra@v1.3.0，看日志里请求的是https://goproxy.cn/...还是proxy.golang.org - 若仍卡住，检查是否漏设
GO111MODULE=on，或项目根目录下存在vendor目录导致跳过代理逻辑
GOPROXY设了但checksum mismatch报错怎么解
这不是网速问题，是模块内容和官方校验记录不一致。镜像源同步延迟、中间代理篡改、本地缓存污染都可能导致。
实操建议：
- 先清本地缓存：
go clean -modcache，再重试 - 确认镜像源是否透传校验和——
goproxy.cn和mirrors.aliyun.com/goproxy/都支持，但某些自建 proxy 若没配GOINSECURE或跳过校验就会出问题 - 临时调试可关校验：
export GOSUMDB=off，但上线前必须恢复，否则失去依赖完整性保护 - 若用私有模块，确保
GOPRIVATE已设，例如export GOPRIVATE=git.example.com/internal/*，否则go仍会尝试走公共 proxy 查
公司内网如何安全用代理又不暴露私有仓库
单一GOPROXY地址会导致私有模块拉不到，全设direct又丢掉加速效果。关键在分层代理策略，不是非此即彼。
实操建议：
- 用逗号拼接多个代理：
export GOPROXY=http://nexus.example.com/repository/goproxy/,https://goproxy.cn,direct - 私有代理（如 Nexus、Artifactory）必须返回标准
/mod/和/zip/接口，且支持 Go Modules 协议 -
GOPRIVATE值要精确匹配私有模块路径前缀，比如git.internal.company.com/mylib就得写git.internal.company.com，通配符不生效 - 别信“加个
no_proxy就行”——Go 不认no_proxy，只认GONOPROXY，但它和GONOSUMDB必须完全一致，否则校验直接失败
Docker 构建中怎么让模块缓存真正复用
Docker 分层缓存不是自动生效的，顺序错了就白搭。很多团队写了go mod download却依然每次重下，就是因为指令位置不对。
实操建议：
- Dockerfile 中，
COPY go.mod go.sum .必须放在最前面，紧接着就是RUN go mod download - 项目代码（
COPY . .）一定要放在这之后，否则任何代码变更都会让前面的缓存失效 - CI 中挂载缓存时，必须同时持久化
$HOME/go/pkg/mod和$GOCACHE两个路径，只缓pkg/mod不够，构建缓存还在$GOCACHE里 - 避免在构建脚本里写
go clean -modcache——这是人为清空缓存，除非真要排查版本冲突，否则毫无必要
direct兜底和GOPRIVATE匹配这两件事是否严格对齐。漏一个，就可能卡住或校验失败。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
