go 1.13+ 私有仓库依赖必须配置 goprivate 跳过代理与校验，并依赖系统 git 完成 https token 或 ssh 认证，缺一环即报 unknown revision、证书错误或 404；module path 必须与仓库地址严格一致，goprivate 需精确匹配路径前缀且无空格。
Go 1.13+ 私有仓库依赖不会自动工作——必须配 GOPRIVATE 告诉 Go “别走代理、别校验 checksum”，再靠系统 git 完成认证；缺任何一环都会卡在 unknown revision、x509 certificate signed by unknown authority 或 404 Not Found。
go mod init 时 module path 必须与 Git 仓库地址结构一致
Go 不做路径重定向，只做字面匹配。模块路径不是“别名”，而是工具链解析 Git URL 的依据。
- 仓库 HTTPS 地址是
https://gitlab.example.com/team/utils，则go mod init必须用gitlab.example.com/team/utils - 若用 SSH 地址
git@gitlab.example.com:team/utils.git，需在~/.gitconfig中配置：[url "git@gitlab.example.com:"] insteadOf = https://gitlab.example.com/，否则go get默认仍走 HTTPS 协议并失败 - 避免用自定义域名（如
mylib.internal）或本地路径（如./utils），除非你已配好 hosts +GOINSECURE+ 自建 proxy，否则 TLS 和 DNS 校验直接拦住
GOPRIVATE 必须精确匹配且无空格
GOPRIVATE 不是“白名单域名”，而是前缀匹配开关。它触发 GONOPROXY 和 GONOSUMDB 的隐式行为，但写错就完全失效。
- 错误写法：
GOPRIVATE=*.example.com→ Go 不支持通配符域名，只认路径前缀 - 错误写法：
GOPRIVATE=gitlab.example.com/→ 缺**，无法匹配gitlab.example.com/team/lib - 错误写法：
GOPRIVATE="gitlab.example.com/**, gitee.com/my-team/*"→ 逗号后空格会导致 Linux/macOS 下只生效第一个 - 正确写法：
go env -w GOPRIVATE="gitlab.example.com/**,gitee.com/my-team/*"（Windows PowerShell 用$env:GOPRIVATE="..."）
git 认证失败才是真实瓶颈
设置了 GOPRIVATE 只是让 Go 直连，真正拉代码的是你本地的 git 命令。如果 git clone https://gitlab.example.com/team/project 失败，go mod tidy 一定失败。
- HTTPS 方式：推荐用
.netrc或git credential store，而非把 token 写进 URL（https://token:x-oauth-basic@...），后者易泄露且部分平台不支持 - SSH 方式：确保私钥已加载到
ssh-agent，且远程仓库已绑定对应公钥；go会调用ssh -o StrictHostKeyChecking=no git@gitlab.example.com，所以首次连接需手动确认 host key 或预置 known_hosts - 内网自签名证书：若报
x509 certificate signed by unknown authority，优先修复证书链；临时方案是设GOINSECURE=gitlab.example.com，但仅限测试环境
GO111MODULE=on 和 go version 必须达标
低于 Go 1.13 的版本根本不识别 GOPRIVATE，而某些 CI 环境或旧脚本会覆盖默认设置，导致模块模式意外关闭。
- 运行
go version，输出必须为go1.13或更高；go1.16+更稳妥，修复了内网证书和**通配匹配的多个边界问题 - 执行
go env -w GO111MODULE=on强制开启，不要依赖auto模式——尤其当项目在$GOPATH/src下时，auto会退化为 GOPATH 模式 - 新建项目务必在空目录下执行
go mod init，避免从$GOPATH/src初始化出错误的 module path（比如推导成cmd或绝对路径）
最常被忽略的是：GOPRIVATE 配对的是路径前缀，不是域名；git 认证独立于 Go 运行时，它失败，Go 就卡死；module path 错一位，整个依赖树就找不到源。这三件事没对齐，再多配置都是徒劳。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
