Go拉取私有仓库报401或“project not found”是因为认证未生效：Go不读.netrc也不继承系统登录态，必须通过git credential.helper存储PAT或配置SSH密钥，并严格匹配GOPRIVATE域名、模块路径与凭据中域名。
go get 报 401 或 “project not found” 是认证没走通
Go 调用 git 拉代码，但它不继承 IDE 或系统登录态，也不读 ~/.netrc（除非你显式启用），更不会自动转发 SSH agent。所以看似“有权限”，实际 go get 根本没带凭证。
- HTTPS 场景下，必须让
git记住凭据：运行git config --global credential.helper store，然后手动执行一次git ls-remote https://gitlab.example.com/group/repo.git，按提示输入用户名 + Personal Access Token（不是密码） - SSH 场景下，模块路径必须是
git@gitlab.example.com:group/repo.git格式，且ssh -T git@gitlab.example.com要能成功；别用https://开头的路径配 SSH key -
.netrc可用但脆弱：文件权限必须是600，machine域名要和go.mod里模块路径的域名**完全一致**（比如gitlab.example.com，不能带端口或路径）
GOPRIVATE 必须设对，否则 proxy 和 checksum 会拦路
GOPRIVATE 不是“可选优化”，而是绕过 GOPROXY 和 sum.golang.org 的开关。设错或漏设，go mod tidy 就会卡在 checksum 验证失败或 410 Gone。
- 值要精确匹配模块域名：如果模块是
gitlab.company.com/group/lib，就设GOPRIVATE=gitlab.company.com，不要加*或路径前缀 - 多个域名用逗号分隔：
GOPRIVATE=gitlab.company.com,gitee.com - 验证是否生效：
go env GOPRIVATE输出应非空；再跑go get -x gitlab.company.com/group/lib，日志里不应出现https://proxy.golang.org或sum.golang.org
go mod tidy 报 “no protocol found for repository” 多半是路径写错了
这个错误常出现在子路径模块（如 gitlab.company.com/group/repo/subpkg）上，根源是 Go 没法从 go.mod 文件反向推导出完整仓库地址。
- 确保私有模块自己的
go.mod第一行是module gitlab.company.com/group/repo（不含/subpkg），子包只是目录结构，不是独立 module - 引用时用完整路径：
import "gitlab.company.com/group/repo/subpkg"，但go.mod里require行仍只写gitlab.company.com/group/repo v1.2.3 - 避免在
replace中写.git后缀：replace gitlab.company.com/group/repo => ./local/path正确，=> gitlab.company.com/group/repo.git错误
Jenkins 或 CI 环境里拉不到私有模块
CI 环境没交互终端、没 ssh-agent、没用户家目录凭据，靠临时配置容易漏掉关键点。
立即学习“go语言免费学习笔记（深入）”；
- 禁止用
--insecure：它只跳 HTTPS 证书校验，不解决认证问题，且 Go 1.21+ 已弃用 - 推荐做法：CI 脚本开头先运行
git config --global url."git@gitlab.example.com:".insteadOf "https://gitlab.example.com/"，再注入 SSH private key 到~/.ssh/id_rsa并chmod 600 - 必须设
GOPROXY=direct：否则即使GOPRIVATE正确，代理仍可能拦截请求；go env -w GOPROXY=direct比临时环境变量更可靠
最易被忽略的是：模块路径、GOPRIVATE 域名、.netrc 或 git config 里的域名三者必须严格一致——差一个端口、一个子路径、甚至大小写，都会静默失败。
