根本原因是Go默认将私有模块视为公开模块，跳过认证流程；需通过GOPRIVATE显式声明私有域名并配合Git层凭证（HTTPS用PAT或SSH用密钥）才能正常拉取。
Go Module拉取私有仓库时提示“unknown revision”或“module not found”
根本原因不是 Git 权限问题，而是 Go 默认把所有模块当公开源处理，不走 SSH/HTTPS 认证流程，直接跳过凭证校验——
根本没尝试登录你的私有 Git 服务器。
必须显式告诉 Go：“这个域名下的模块是私有的，别走公共代理，也别缓存 checksum，直接走 Git 原生协议拉。”
环境变量是开关，只控制“是否绕过 proxy 和 checksum 验证”，不解决认证问题
Git 认证仍需靠
或
，和 Go 本身无关
如果用 HTTPS 地址（如
），确保
能通
如果用 SSH 地址（如
），Go 会调用
命令，依赖本地 SSH agent 或
GOPRIVATE 怎么设才生效：域名匹配规则很严格
不是模糊匹配，也不支持通配符子域名自动包含。比如设成
，不会覆盖
或
。
多个域名用逗号分隔，不能有空格：
支持
但仅用于前缀匹配，例如
匹配
和
，但不匹配
（无子域）
如果模块路径含端口（如
），
必须写成
，端口不能省略
设置后建议验证：
，且运行
看是否还报
为什么设置了 GOPRIVATE 还 401？检查 Git 协议层是否真能连
Go 把模块下载委托给
命令，
只是让 Go 别拦着它。所以 401 错误一定出在 Git 层面，和 Go 无关。
立即学习
“
go语言免费学习笔记（深入）
”；
手动执行等价命令：
，看是否要密码或 token
HTTPS 私仓推荐用 Personal Access Token（PAT）代替密码，配置方式：
SSH 私仓确认
能通，且
进程能读到你的
（CI 环境常漏掉）
公司内网 GitLab 自建实例若启用了反向代理，注意
仅限测试，生产慎用
go.mod 中 replace 和 indirect 依赖的坑
私有模块一旦被间接依赖（indirect），
仍生效，但容易因版本不一致触发
。
不要在
里对私有模块写
指向本地路径，除非调试；上线前必须删掉，否则别人
会失败
如果私有模块 A 依赖私有模块 B，且 B 的路径不在
列表里，A 就会拉不到 B——
必须覆盖整条依赖链上的所有私有域名
升级私有模块时，用
显式指定分支，避免 Go 自动选错 tag（尤其当远程没打规范语义化版本时）
最常被忽略的是：GOPRIVATE 域名没覆盖完整依赖树，或者 Git 凭证只配了 HTTPS 却在 go.mod 里写了 SSH 地址——两者只要错一个，就卡在 “unknown revision”。
go getGOPRIVATEgit config~/.netrchttps://git.example.com/internal/libgit clone https://git.example.com/internal/libgit@git.example.com:internal/libgit~/.ssh/configGOPRIVATEexample.comgit.example.comdev.git.example.comexport GOPRIVATE=git.example.com,my.company.internal**.example.comgit.example.comapi.example.comexample.comgit.example.com:2222/internal/libGOPRIVATEgit.example.com:2222go env GOPRIVATEgo list -m allverifying ...: checksum mismatchgitGOPRIVATEgit ls-remote -q https://git.example.com/internal/lib.git refs/heads/maingit config --global url."https://token:x-oauth-basic@git.example.com/".insteadOf "https://git.example.com/"ssh -T git@git.example.comgoSSH_AUTH_SOCKgit config --global http.https://git.example.com.sslVerify falseGOPRIVATErequire X: version "v0.1.0" used for two different module pathsgo.modreplacego buildGOPRIVATEGOPRIVATEgo get git.example.com/internal/lib@main