go mod download卡在proxy.golang.org主因是未配置国内代理及GOSUMDB校验失败，须设GOPROXY=https://goproxy.cn,direct并视情关GOSUMDB或配私有校验源，私有仓库需用GOPRIVATE指定前缀且确保Git认证有效。
go mod download 卡在 proxy.golang.org 怎么办
受限网络环境下，go mod download 默认走 proxy.golang.org 会超时或拒绝连接，根本原因是 Go 没配置可用代理且 GOSUMDB 强制校验远程模块哈希。
- 必须显式设置国内可访问的代理：
go env -w GOPROXY=https://goproxy.cn,direct（或https://mirrors.tencent.com/goproxy/） - 同时禁用默认校验服务：
go env -w GOSUMDB=off—— 否则即使代理通了，go.sum校验仍会失败 - 若企业要求保留校验，则需部署私有
sum.golang.org镜像，或改用GOSUMDB=sum.golang.org+https://your-internal-sumdb.example.com - 验证是否生效：
go env GOPROXY GOSUMDB，输出应不含proxy.golang.org和sum.golang.org
私有 Git 仓库模块拉取失败：401 或 no such host
当 go get 尝试拉取 git.internal.com/team/repo 时返回 401 或 DNS 解析失败，不是权限问题本身，而是 Go 没被告知“这是私有源”。
- 用
go env -w GOPRIVATE=git.internal.com告诉 Go 跳过代理和校验——注意不能写成git.internal.com/*，Go 只认前缀匹配 - 如果私有仓库走 SSH（如
git@git.internal.com:team/repo.git），确保$HOME/.ssh/id_rsa存在且ssh-agent已加载密钥；HTTP 地址则需.netrc或git config --global credential.helper store - 检查
go.mod中模块路径是否与 Git 仓库 URL 一致：比如仓库 URL 是https://git.internal.com/team/repo，module行就必须是module git.internal.com/team/repo - 临时测试拉取：
go mod download git.internal.com/team/repo@v1.2.0，失败时加-v查看真实错误源
go.sum 校验失败但模块实际可用，能跳过吗
可以，但必须明确知道后果：go.sum 失败通常意味着模块内容被篡改、镜像缓存损坏，或企业内部代理重写了响应体。
- 开发阶段临时绕过：
GOINSECURE=git.internal.com go mod download—— 仅对指定域名禁用 TLS 和校验 - CI/CD 中不建议全局关
GOSUMDB，而应让构建机信任企业根证书，并配置git config --global http."https://git.internal.com".sslCAPath /path/to/cert.pem - 若使用 vendor 目录，
go mod verify仍会校验vendor/下文件哈希，此时go.sum错误不影响构建，但说明本地缓存已脏，应清空$GOPATH/pkg/mod/cache后重试 - 真正安全的做法是：把私有模块 fork 到可信仓库，用
replace指向内部地址，并提交其go.sum入库
CI 构建因依赖源不可达中断，怎么防住
核心不是让 CI “连得上”，而是让它“不依赖外部网络”——所有依赖必须可离线复现。
立即学习“go语言免费学习笔记（深入）”；
- 强制启用
vendor并提交：go mod vendor后git add vendor/，CI 中用go build -mod=vendor - CI 脚本开头加检查：
! git status --porcelain | grep -q '^vendor/'，防止开发者漏提交 vendor 变更 - 对关键模块（如
golang.org/x/net）做双保险：replace golang.org/x/net => ./vendor/golang.org/x/net，避免go build时仍尝试联网 - 禁止 CI 使用
@latest：go list -m all | grep '@latest'有输出则直接 fail，杜绝非确定性依赖
GOPRIVATE 的前缀匹配规则和 go.sum 在 vendor 模式下的双重校验逻辑——这两处一错，整个依赖链就变成黑盒。 
