先确认GOPRIVATE是否生效：Go默认走公共代理，私有仓库拉取失败八成因GOPRIVATE未正确配置；需用go env -w GOPRIVATE="域名/*"设置并验证输出，同时确保Git层认证（SSH密钥或HTTPS Token）就绪。
go mod 无法拉取私有仓库？先确认 GOPRIVATE 是否生效
绝大多数私有仓库拉取失败，根本原因不是网络或权限问题，而是 GOPRIVATE 没设对或没生效。Go 工具链在遇到模块路径匹配 GOPRIVATE 时，才会跳过代理、跳过校验、直连 Git——否则一律走 proxy.golang.org，而私有地址显然不在其索引中。
验证是否生效最直接的方法是执行：
go env GOPRIVATE
如果输出为空，说明没设置；如果输出是 gitlab.example.com 但实际仍报错，可能是：
- 域名拼写错误（比如漏了
.com或多写了https://） - 用了通配符但没加
/*（gitlab.example.com≠gitlab.example.com/*） - 设置了环境变量但没持久化（比如只在当前终端
export，没用go env -w）
设置 GOPRIVATE 的正确姿势：go env -w + 通配符 + 多域名逗号分隔
go env -w 是唯一推荐的设置方式，它写入 Go 的配置文件（$GOPATH/go/env），跨终端、跨 Shell 生效。别再用临时 export 或 Windows 的 set。
立即学习“go语言免费学习笔记（深入）”；
常见配置示例：
go env -w GOPRIVATE="gitlab.company.com/*,gitee.com/myteam/*,*.internal"
注意几点：
- 通配符
*必须显式写出，gitlab.company.com不会自动匹配子路径 - 多个域名用英文逗号
,分隔，**不能有空格** -
*.internal这种泛域名写法有效，但仅匹配一级子域（如api.internal✅，svc.api.internal❌） - 如果模块路径不含域名（如
my.private.module），也必须列进GOPRIVATE
为什么还要配 GONOSUMDB 和 GOINSECURE？
GOPRIVATE 默认会同步影响 GONOPROXY 和 GONOSUMDB，但有两个例外场景必须手动补全：
- 内网 GitLab 使用自签名 HTTPS 证书 → 需要
go env -w GOINSECURE="gitlab.company.com"，否则git clone会因 TLS 验证失败中断 - 私有仓库部署在 HTTP 协议（非 HTTPS）→ 同样必须加到
GOINSECURE，否则 Go 直接拒绝连接 - 你明确关闭了校验和检查（比如用自建 sumdb 或完全信任内网）→ 显式设
go env -w GONOSUMDB="gitlab.company.com/*"更清晰，避免依赖默认继承逻辑
顺带一提：GONOSUMDB 和 GOPRIVATE 值可以不同。例如你只想跳过校验但不跳过代理（极少见），就单独设前者。
Git 认证失败？Go 不管登录，只靠系统 Git
Go 工具链本身**不处理任何认证逻辑**。它只是调用系统 git 命令，比如 git clone https://gitlab.company.com/team/lib.git。所以认证失败，问题一定出在本地 Git 配置上。
排查顺序建议：
- 先手动执行
git clone https://gitlab.company.com/team/lib.git，看是否成功 - 失败则检查：
.netrc文件（Linux/macOS）、Windows 凭据管理器、SSH 密钥（~/.ssh/id_ed25519）、或 Git URL 重写规则（git config --global url."git@gitlab.company.com:".insteadOf "https://gitlab.company.com/"） - HTTPS 场景下，Token 应放在 URL 中：
https://token:x-oauth-basic@gitlab.company.com/team/lib.git，或通过.netrc维护
最容易被忽略的一点：CI/CD 环境里，git 可能没配置凭证，或 SSH Agent 没启动，此时 go mod tidy 必然卡住或报错。
