90%私有库拉取失败是Git凭证未生效，而非GOPRIVATE配置错误；需确保git凭据助手全局注册（HTTPS用credential.helper，SSH验证ssh -T及git ls-remote），GOPRIVATE域名精确匹配（含端口和/*/通配符），且GO111MODULE=on。
Go 拉取私有库失败，90% 是凭证没生效，不是 GOPRIVATE 配错了。 设置完 GOPRIVATE 还报 401 Unauthorized 或 Host key verification failed，说明 Go 已跳过代理、直连了仓库，但底层 git 命令拿不到登录凭据——问题在 Git 层，不在 Go 层。
为什么 git clone 能通，go mod tidy 却 401？
Go 调用的是系统 git 命令拉代码，但它不读 ~/.netrc，也不自动转发 IDE 或终端里的登录态。你手动 git clone https://git.example.com/org/repo 成功，只说明当前 shell 环境下凭据可用；而 go mod tidy 启动的是新进程，凭据助手必须全局注册才有效。
- HTTPS 场景：确保已运行
git config --global credential.helper store（明文存本地，仅限开发机）或git config --global credential.helper libsecret（GNOME）/osxkeychain（macOS） - 首次触发凭据输入时，用户名填个人访问令牌（
PAT），密码栏留空或也填PAT（GitHub/GitLab 要求） - 验证是否生效：新开终端，执行
git ls-remote https://git.example.com/org/repo.git，不提示输密码即成功 - 别在 URL 里硬写 token（如
https://token:x-oauth-basic@git.example.com/...），go mod会解析失败或泄露风险高
SSH 私有库连不上，先确认三件事
Go 对 SSH URL 的处理是“原样透传”，成败完全取决于本地 git 是否能无交互连接。报 Host key verification failed 或 Permission denied (publickey)，不是 Go 配置问题，而是 SSH 链路未打通。
- 模块路径必须是
git@example.com:org/repo.git格式（冒号分隔），且go.mod中的module声明需与之匹配，例如module example.com/org/repo - 运行
ssh -T git@example.com和git ls-remote git@example.com:org/repo.git都必须成功；任一失败，go get必败 -
~/.ssh/config中 Host 别名要精确对应域名（含端口）：Host example.com→User git→IdentityFile ~/.ssh/id_rsa_private - CI 环境中，私钥文件权限必须为
600，且需用ssh-add加载（ssh-agent必须已启动）
GOPRIVATE 配对错误：域名不匹配是最常见漏点
GOPRIVATE 不是模糊白名单，它做前缀匹配。写错一个字符、漏掉 /*、多一个空格，私有模块就会被代理拦截或校验失败。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 如果模块路径是
git.internal.company.com/team/lib，GOPRIVATE必须设为git.internal.company.com/*，不是internal.company.com/*或git.internal.company.com（缺/*） - 多个域名用英文逗号分隔，**不能有空格**：
go env -w GOPRIVATE=git.example.com/*,github.com/my-org/* - 带端口的地址（如
git.example.com:2222）必须完整写出端口，GOPRIVATE不会自动忽略 - 验证方式：
go env GOPRIVATE输出应与设置一致；再跑go list -m all 2>&1 | grep "sum.golang.org"，若仍有校验请求，说明匹配失败
GO111MODULE=on 是所有配置生效的前提
没开模块模式，go mod 命令静默无效，GOPRIVATE、GOPROXY 全部不生效，依赖仍走旧版 $GOPATH/src 路径。
- 执行
go env -w GO111MODULE=on永久启用（推荐） - 检查输出：
go env GO111MODULE必须返回on，不是auto或空 - 若返回
auto，说明当前目录在$GOPATH/src下——直接移出该路径再试，别指望 auto 切换 - 老项目迁移时，
go mod init后务必删掉vendor/和go.sum重生成，避免缓存干扰
真正卡住的地方，往往不是配置项本身，而是 Git 凭据助手没注册、SSH 私钥没加载、或者 GOPRIVATE 域名少写了 /*。这些问题不会报“配置错误”，只会安静地返回 401 或 timeout——得一层层往下查 git 调用链，而不是反复调 Go 环境变量。
