go mod无法拉取自建gitlab仓库的主因是模块路径、认证与goprivate三者未对齐：需精确设置goprivate为gitlab.company.com（不含通配符陷阱），确保go.mod中module路径与仓库url一致，并通过git credential或ssh打通git层认证。
go mod 无法拉取自建 GitLab 仓库的常见错误
直接运行 go mod tidy 或 go get 就报错，典型现象有：go: gitlab.company.com/group/lib@v1.2.0: reading gitlab.company.com/group/lib/go.mod at revision v1.2.0: git ls-remote -q origin: exit status 128: remote: The project you were looking for could not be found...，或者 no protocol found for repository。这不是 Go 本身不支持私有库，而是模块路径、认证、代理三者没对齐。
GOPRIVATE 必须精确匹配域名，且不含通配符陷阱
设成 go env -w GOPRIVATE="*.company.com" 是无效的——Go 不支持 * 前缀通配（除非用 *.company.com，但仅匹配子域，不匹配 company.com 本身）。真实场景中，模块路径是 gitlab.company.com/group/lib，那 GOPRIVATE 就必须写成 gitlab.company.com，不能少也不能多。
- 多个域名用英文逗号分隔，**不能有空格**：
go env -w GOPRIVATE="gitlab.company.com,git.internal.dev" - 如果 GitLab 启用了非标准端口（如
gitlab.company.com:8080），GOPRIVATE里也必须带上端口：gitlab.company.com:8080 - 设置后务必验证：
go env GOPRIVATE输出应与你设置的完全一致
Git 层认证必须独立打通，Go 本身不处理登录
Go 只负责解析模块路径并调用 git clone，所有认证都由 Git 自己完成。所以 go mod tidy 失败，本质是 git clone https://gitlab.company.com/group/lib.git 这条命令跑不通。
- HTTPS 方式：用 Personal Access Token（需勾选
read_repository），推荐配置git config --global credential.helper store，然后执行一次git clone输入token当密码，Git 会存到~/.git-credentials - SSH 方式：确保
ssh -T git@gitlab.company.com能成功返回欢迎信息；go默认走 HTTPS，所以还得加git config --global url."git@gitlab.company.com:".insteadOf https://gitlab.company.com/ - 不要在
go.mod里硬编码 token 或密码，否则go mod vendor后仍需运行时认证，且存在泄露风险
go.mod 中的 module 路径必须与 Git 仓库地址结构一致
比如你的仓库实际 URL 是 https://gitlab.company.com/group/lib.git，那 go.mod 第一行就必须是 module gitlab.company.com/group/lib。少个 .git、多一层目录、大小写不一致，都会导致 unknown revision 错误。
- 新建私有模块时，不要用
go mod init mylib，而要用go mod init gitlab.company.com/group/lib - 如果已发布版本打了 tag（如
v1.2.0），确保该 tag 在对应仓库里真实存在，且go.mod文件在该 commit 中存在 - replace 语句不是万能解药，仅用于临时覆盖；正式依赖必须靠路径+认证+GOPRIVATE 三者闭环
go.mod 路径、GOPRIVATE 域名、Git 凭据三者之间有一处没对齐——建议按顺序逐项验证：先 git clone 成功，再确认 go env GOPRIVATE，最后检查 go.mod 的 module 行。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
