必须配置GOPRIVATE环境变量，否则Go工具链将私有模块误作公开模块经proxy访问而失败；还需配合Git认证配置和GOSUMDB=off或+insecure以解决拉取、校验及CI/CD问题。
Go私有仓库模块必须配置 GOPRIVATE
不设 GOPRIVATE，Go 工具链默认把所有非 golang.org/x 域名的模块都当公开模块走 proxy（如 proxy.golang.org），结果就是：私有 Git 地址（如 git.example.com/internal/utils）直接报 module lookup failed 或 403 Forbidden —— 因为 proxy 根本没权限访问你的内网仓库。
解决方式是让 Go 跳过 proxy 和 checksum 验证，直连你的私有源。核心就一条环境变量：
export GOPRIVATE=git.example.com
如果多个域名，用逗号分隔：
export GOPRIVATE=git.example.com,github.company.internal
注意：GOPRIVATE 支持通配符，但只认 *（不是正则），例如 *.example.com 匹配 git.example.com 和 pkg.example.com；example.com 不匹配子域。
私有模块拉取失败？检查 Git 协议与认证方式
即使设了 GOPRIVATE，仍可能卡在 go get 时的 Git 认证环节。常见现象：
fatal: could not read Username for 'https://git.example.com': No such device or addressPermission denied (publickey)
原因在于 Go 默认用 https 协议克隆模块，但你的私有 Git 服务可能只支持 SSH 或要求 token 认证。解决方法：
- 强制 Git 使用 SSH：在
~/.gitconfig中添加重写规则：[url "git@git.example.com:"] insteadOf = https://git.example.com/ - 若必须用 HTTPS + token，在
~/.netrc写入凭据：machine git.example.com login <code>your-username</code> password <code>your-personal-access-token</code>
（注意：token 权限需含read_package_registry或对应 repo 权限） - 确保本地 Git 能手动
git clone成功，Go 的go get本质复用同一套 Git 配置
go mod download 报 checksum mismatch？关掉 GOSUMDB
私有模块没有发布到官方 checksum 数据库（sum.golang.org），所以 go mod download 或 go build 时会校验失败，报类似：
verifying git.example.com/internal/utils@v0.1.0: checksum mismatch
这是因为 Go 默认开启 GOSUMDB，对所有模块（包括 GOPRIVATE 域名）也尝试查 checksum。正确做法是显式关闭校验：
export GOSUMDB=off
或更安全地，仅对私有域禁用（推荐）：
export GOSUMDB=sum.golang.org+insecure
注意：+insecure 表示“对 GOPRIVATE 列出的域名跳过 checksum 校验”，其余模块仍受保护。
CI/CD 中私有模块不可用？环境变量和 Git 凭据要一起注入
本地能跑不代表 CI 环境能跑。典型问题：流水线里 go mod tidy 失败，提示无法访问私有 Git。
关键点有三个：
- CI 作业中必须设置
GOPRIVATE和GOSUMDB（不能只靠本地 shell profile） - Git 凭据不能靠
~/.netrc（CI 容器通常无该文件），应改用环境变量注入后生成：echo "machine git.example.com login $GIT_USER password $GIT_TOKEN" > ~/.netrc
- SSH 方式需提前注入私钥并配置
ssh-agent，且确保known_hosts已预置目标 Git 服务器指纹，否则首次连接会 hang 住
最容易被忽略的是：私有模块的 go.mod 文件里写的 module path 必须和 Git 仓库 URL 严格一致（比如 module git.example.com/internal/utils 对应 https://git.example.com/internal/utils.git），否则 Go 会按路径拼 URL，导致 404。
