答案是go mod tidy报unknown revision或module not found，因go工具链严格按go.mod中module路径解析Git地址，若路径与实际HTTPS/SSH地址结构不一致（如域名或路径错配）、GOPRIVATE未正确配置导致代理/校验干扰、或Git认证未通（凭据系统失效），均会失败。
私有包拉取失败，90% 是因为 GOPRIVATE 没配对、Git 认证没走通、或 go.mod 中模块路径与实际 Git 地址不一致。
为什么 go mod tidy 报 unknown revision 或 module not found
Go 工具链不会“猜”你私有仓库在哪——它严格按 go.mod 里声明的模块路径（如 git.example.com/internal/utils）去解析 Git URL。如果该路径无法映射到可访问的 HTTPS/SSH 地址，就会失败。
- 检查
go.mod第一行：module后的路径必须和你git clone用的地址结构完全对应（协议无关，但域名+路径要一致） - 比如仓库真实地址是
https://git.example.com/group/lib，那go.mod必须写module git.example.com/group/lib，不能写成mylib.local/group/lib或example.com/lib - 若用 SSH 地址（
git@git.example.com:group/lib.git），需在~/.gitconfig中配置：[url "git@git.example.com:"] insteadOf = https://git.example.com/，否则go默认走 HTTPS 协议并卡住
GOPRIVATE 配置不对，go 会跳过代理但不跳过校验
GOPRIVATE 的作用只有两个：跳过 GOPROXY 代理、跳过 TLS 证书校验（仅限 HTTPS）。它**不负责认证**，也不自动帮你登录。
- 设置方式（推荐全局）：
go env -w GOPRIVATE=git.example.com,github.com/myorg/private - 如果只设子域名（如
example.com），但模块路径是git.example.com/group/lib，则必须写全git.example.com，否则不生效 -
GOINSECURE仅用于跳过自签名证书校验，**不能替代认证**；且仅对 HTTP/HTTPS 生效，对 SSH 无效
Git 认证没通，go get 就是 git clone
go 命令底层调用的是 git clone，所有认证逻辑完全复用 Git 凭据系统。Go 本身不管理 token 或密码。
立即学习“go语言免费学习笔记（深入）”；
- HTTPS 方式：优先走
git credential（如git config --global credential.helper store），或 URL 中嵌入 token：https://<code>token:x-oauth-basic@git.example.com/group/lib（注意平台兼容性，GitHub/GitLab 支持，Gitea 需开启对应选项） - SSH 方式：确保
ssh-agent已加载私钥（ssh-add -l可查），且远程仓库已绑定对应公钥；go会自动执行ssh -o StrictHostKeyChecking=no git@git.example.com - 绝对不要在
go.mod或代码里硬编码密码/token——go mod vendor后仍需运行时认证，且存在泄露风险
内网环境没外网，GOPROXY 和 vendor 怎么选
两者不是互斥方案，而是不同阶段的补位手段：代理解决“拉不到”，vendor 解决“不敢拉”或“不能连”。
- 搭私有代理（如 Athens、Nexus）：设
GOPROXY=http://intranet-proxy:8080，所有依赖（包括私有模块）都经它缓存转发，要求代理服务能访问你的私有 Git 服务器 - 用
go mod vendor：生成vendor/目录后，go build -mod=vendor强制只读该目录；但注意：它不解决首次拉取问题——你得先在能联网的机器上跑通go mod tidy，再把vendor/打包带进内网 -
replace是临时开发手段，上线前必须删掉或改成本地相对路径（如replace git.example.com/internal/utils => ./local/utils），否则部署机找不到路径
真正卡住人的从来不是 Go 语法，而是 Git 地址、GOPRIVATE、凭据三者没对齐。调试时先手动 git clone 那个模块路径，成功了再让 go 跑——这是最可靠的验证顺序。
