Go管理私有模块需GOPRIVATE匹配路径、Git认证可用、模块路径与仓库地址严格对齐三者协同；仅设GOPRIVATE不足，GOINSECURE不解决证书问题，replace非部署方案，git层不通则go mod tidy必报unknown revision或module not found。
Go 管理私有模块不是靠“隐藏代码”，而是靠环境变量、Git 配置和路径对齐三者协同生效。只设 GOPRIVATE 不够，GOINSECURE 不能代替证书配置，replace 也不能替代真实拉取路径 —— 这些组合错一个，go mod tidy 就会卡在 unknown revision 或 module not found。
怎么让 go 工具链识别私有模块路径
Go 不会凭域名自动判定私有性，它只看模块路径是否匹配 GOPRIVATE 中的通配符。匹配后才跳过代理和校验，但拉取动作仍由 git 执行，所以路径必须能映射到真实仓库地址。
-
GOPRIVATE=git.example.com/**→ 匹配git.example.com/a/b/c，但GOPRIVATE=*.example.com无效（Go 不支持域名通配） - 多个域名用逗号分隔，**不能有空格**：
GOPRIVATE=git.example.com/**,gitee.com/my-org/* - 模块路径（
go.mod第一行）必须与 Git 仓库 HTTPS/SSH 地址结构一致，比如仓库是https://git.example.com/group/lib，那模块路径就得是git.example.com/group/lib - 如果用了 SSH 地址（
git@git.example.com:group/lib.git），但没配git config --global url."git@git.example.com:".insteadOf "https://git.example.com/"，go默认仍走 HTTPS 并失败
为什么设置了 GOPRIVATE 还报 x509 错误
GOPRIVATE 只控制是否走代理、是否查 sumdb，不控制 TLS 证书验证。自签名或内网 CA 证书仍会被 Go 拒绝，因为底层调用的是 git clone，而 git 默认校验证书。
- 临时开发可用
GOINSECURE=git.example.com（仅限本地，禁止上 CI） - 生产环境应把内网 CA 证书加入系统信任链，或运行：
git config --global http."https://git.example.com/".sslCAInfo /path/to/ca.crt - 检查是否生效：
git ls-remote -q https://git.example.com/group/lib，成功才说明 Git 层已通
replace 和 indirect 依赖怎么处理私有模块
replace 是开发期便利写法，不是私有模块的正式解决方案；indirect 依赖只要路径匹配 GOPRIVATE，就会自动按私有规则解析，无需额外操作。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
-
replace git.example.com/internal/utils => ./internal/utils提交前必须注释掉，否则别人 clone 后无法构建 - 私有模块若有未打 tag 的变更，别用
master或latest—— Go 不支持分支名，改用伪版本（如v0.0.0-20240520123456-abcdef123456）或打轻量 tag -
go.sum里记录的是原始模块哈希，不是本地路径内容；replace下本地改代码不会触发校验失败，上线前务必确认最终依赖一致性
SSH 协议下拉取失败的常见原因
Go 本身不处理 SSH，完全依赖 git 的凭据和密钥配置。即使 GOPRIVATE 和路径都对了，SSH 层不通照样失败。
- 确保
~/.ssh/id_rsa（或对应私钥）已添加到ssh-agent：ssh-add -l查看 - 远程仓库需已配置对应公钥；测试命令：
ssh -T git@git.example.com - 若用非默认端口（如 2222），SSH URL 必须显式带端口：
git@git.example.com:2222/group/repo.git，且git config的insteadOf规则也要同步更新 - CI 环境中常漏掉
ssh-agent启动或密钥注入，建议统一用 HTTPS + token 方式（如https://token:x-oauth-basic@git.example.com/group/repo），更易自动化
最易被忽略的是：Git 层的认证状态和 Go 层的模块路径必须严格对齐。很多问题表面是 Go 报错，实际是 git clone 失败后返回的模糊提示。调试时优先跑一遍 git ls-remote，比反复改 GOPRIVATE 有效得多。
