私有Git仓库地址必须与module path完全一致，Go只认go mod init时指定的字符串；GOPRIVATE仅控制跳过代理和校验，不解决认证问题，真正拉取依赖由git命令执行，需确保git clone能通且凭证有效。
私有 Git 仓库地址必须与 module path 完全一致
Go 不会自动把 gitlab.example.com/team/project 映射成 example.com/project ——它只认你 go mod init 时写的那个字符串。如果模块初始化写的是 go mod init myproject，后续所有 import、go get、CI 构建都会按这个路径找，跟 Git 仓库 URL 无关。
常见错误现象：go get gitlab.example.com/team/project 报 unknown revision，但 git clone https://gitlab.example.com/team/project 能成功。
- 新建项目时，直接在空目录执行
go mod init gitlab.example.com/team/project（不是go mod init project） - module path 必须是未来仓库的 HTTPS 或 SSH 地址前缀（不含协议），且大小写敏感
- GitLab 项目路径含下划线或大写字母？module path 也得照写，Go 不做任何转换
- 已有项目改 module path？需全局替换所有 import 行，并运行
go mod tidy清理旧引用
GOPRIVATE 是开关，不是路由表
GOPRIVATE 的作用不是“告诉 Go 去哪拉代码”，而是“告诉 Go 别走 GOPROXY、别查 sum.golang.org”。真正拉代码的是系统 git 命令，Go 只负责拼 URL 并调用它。
常见错误现象：配置了 GOPRIVATE=*.example.com 仍报 x509 certificate signed by unknown authority 或 404 Not Found。
立即学习“go语言免费学习笔记（深入）”；
-
GOPRIVATE不支持通配符*匹配域名（如*.gitlab.example.com无效），只支持路径前缀匹配 - 正确写法：
go env -w GOPRIVATE="gitlab.example.com/**,gitee.com/my-team/*"（**匹配任意深度子路径） - 多个域名必须用英文逗号分隔，**中间不能有空格**，否则 Linux/macOS 下只会生效第一个
- Windows PowerShell 用户需用
$env:GOPRIVATE="gitlab.example.com/**"，CMD 用set GOPRIVATE=gitlab.example.com/**
git 认证失败 = go get 必败
设置了 GOPRIVATE 后，Go 会尝试用 git clone https://gitlab.example.com/team/project 拉代码。如果这一步失败，go get 绝对失败，且错误信息往往藏在深层日志里。
常见错误现象：go get gitlab.example.com/team/project 卡住几秒后报 unknown revision，但没提示认证问题。
- 先手动跑一遍
git clone https://gitlab.example.com/team/project，确认是否弹密码或 Token 提示 - HTTPS 方式：配置
git config --global credential.helper store，然后首次 clone 输入用户名+Personal Access Token - SSH 方式：确保
~/.ssh/id_rsa.pub已添加到 GitLab 账户，且git clone git@gitlab.example.com:team/project.git能通 - 内网 GitLab 自签证书？需额外配置
git config --global http."https://gitlab.example.com/".sslVerify false（仅限可信内网）
replace 仅用于本地开发，不可提交到 CI
go mod edit -replace 是临时绕过远程依赖的调试手段，本质是硬编码本地路径。它不解决私有仓库认证问题，也不参与构建产物生成。
常见错误现象：本地 go run 正常，CI 流水线 go build 失败，报找不到包。
-
replace指令写入go.mod后，会被go mod tidy保留，但 CI 环境没有对应本地路径，必然失败 - 上线前务必删掉
replace行，改用真实私有仓库地址 + 正确GOPRIVATE+ git 认证 - 想隔离测试？用
go mod edit -dropreplace清除，或临时加-mod=readonly阻止修改 - CI 中若需覆盖依赖（如打补丁），应使用
go mod edit -replace+go mod download，再 commit 修改后的go.sum，而非依赖本地路径
