根本原因是go默认将私有模块视为公开模块，强制走sum.golang.org校验；必须通过精确匹配域名（含端口）的goprivate环境变量绕过代理和校验，同时确保git层认证（https凭据或ssh密钥）就绪。
go mod tidy 报 verifying 失败或 410 Gone
根本原因是 Go 默认把私有仓库当公开模块处理，强制走 sum.golang.org 校验，而私有地址无法被该服务索引。设置 GOPRIVATE 是绕过这层校验的唯一可靠方式。
-
GOPRIVATE必须精确匹配域名（含端口），例如gitlab.company.com:8080和gitlab.company.com视为不同域名，不能省略端口 - 支持
*前缀通配，如*.company.com匹配gitlab.company.com和api.company.com，但不匹配company.com - 多个域名用英文逗号分隔、**无空格**：
gitlab.company.com,gitee.com/my-team - Windows PowerShell 用户需用
$env:GOPRIVATE="..."，CMD 用setx GOPRIVATE "..." - 设完后运行
go env GOPRIVATE确认生效，再执行go mod tidy—— 若仍报verifying ... checksum mismatch，说明没生效或域名不匹配
git clone 成功但 go get 仍 401 或 terminal prompts disabled
Go 本身不处理认证，它调用系统 git 命令拉代码。GOPRIVATE 只是让 Go 不拦着，真正失败点在 Git 层。
- HTTPS 场景：必须配置凭据，推荐用
.netrc文件（Linux/macOS）或 Windows 凭据管理器，内容格式为：machine gitlab.company.com login <username> password <token></token></username> - SSH 场景：确保
git clone git@gitlab.company.com:group/project.git能通；ssh -T git@gitlab.company.com应返回欢迎信息；Go 会复用系统 SSH agent -
terminal prompts disabled错误不是 Go 的问题，而是git默认禁用交互式输入；临时解决可设GIT_TERMINAL_PROMPT=1，但生产环境严禁依赖手动输密码 - 验证 Git 层是否就绪：直接运行
git ls-remote https://gitlab.company.com/group/project.git或git ls-remote git@gitlab.company.com:group/project.git，成功才代表 Go 能拉
go get 显示 unknown revision 或 module not found
这不是 Go 模块系统的问题，而是路径、版本或权限三者之一出错。
- 检查
go.mod中 import path 是否与仓库实际 URL 完全一致（包括大小写、.git后缀、子路径），例如gitlab.company.com/group/lib≠gitlab.company.com/group/lib.git - 确认目标仓库存在对应 tag（如
v1.2.0）或 commit hash；go get gitlab.company.com/group/lib@v1.2.0失败时，先用浏览器访问https://gitlab.company.com/group/lib/-/tree/v1.2.0验证 - 私有仓库需确保当前凭据有读取权限 —— 即使
git clone能通，也可能因项目 visibility 设置或 token scope 不足导致 Go 拉不到特定 ref - 避免在
go.mod中滥用replace：它只影响构建时解析，不解决go mod tidy的网络拉取问题；且上线前必须移除，否则线上环境找不到本地路径
GOPROXY 和 GOPRIVATE 配置冲突导致 403
国内用户常配了镜像代理却忘了排除私有域，结果 Go 尝试用 https://goproxy.cn 去查 gitlab.company.com，自然返回 403。
- 务必让
GOPRIVATE覆盖所有私有域名，且不能漏掉子域名或端口变体 - 调试时可临时设
GOPROXY=direct验证是否代理干扰：GOPROXY=direct go mod tidy—— 若此时成功，说明原GOPROXY配置未配合GOPRIVATE - 推荐组合配置：
GOPROXY=https://mirrors.tuna.tsinghua.edu.cn/go/modules/,https://goproxy.cn,direct+GOPRIVATE=gitlab.company.com,gitee.com/my-team - 注意
GONOSUMDB已被弃用，GOPRIVATE同时替代其功能；设了GOPRIVATE后无需额外设GONOSUMDB
GOPRIVATE 却没验证 git clone 是否真能通，或者域名写错一级子域、漏了端口、凭据过期。每一步都要单独验证，别指望 go mod tidy 一次跑通。
