GOPRIVATE未生效导致checksum mismatch的根本原因是环境变量未被识别或值不匹配模块路径前缀；必须精确匹配import路径前缀（如gitlab.example.com/myorg），不能含协议或空格，且需在Docker/CI中显式设置并确保子shell继承。
私有库拉取报 checksum mismatch 错误时，GOPRIVATE 没生效？
根本原因通常是 GOPRIVATE 环境变量没被 Go 工具链识别到，或者值写错了。它不是“加了就自动跳过校验”，而是必须精确匹配模块路径前缀，且不能带协议、不能有多余空格。
-
GOPRIVATE值是逗号分隔的模块路径前缀（如gitlab.example.com/myorg），不是 URL（别写成https://gitlab.example.com/myorg） - 如果私有模块路径是
gitlab.example.com/myorg/pkg，GOPRIVATE必须包含gitlab.example.com/myorg或更宽泛的gitlab.example.com - 在 CI 或 Docker 构建中，容易漏设该变量——Go 不会从 shell 的
.bashrc自动加载，得显式export GOPRIVATE=...或写进构建脚本 - Windows 用户注意：PowerShell 用
$env:GOPRIVATE="..."，CMD 用set GOPRIVATE=...，语法不通用
为什么设置了 GOPRIVATE 还提示 verifying github.com/...@vX.Y.Z: checksum mismatch？
这个错误说明 Go 仍在尝试从 proxy（比如 proxy.golang.org）下载模块并校验 checksum，意味着它没把你的模块识别为“私有”，从而没跳过校验流程。
- 检查
go env GOPRIVATE输出是否真包含你模块的完整域名+路径前缀（大小写、点号、斜杠都要一致） - 确认模块的
go.mod里module行写的路径和GOPRIVATE前缀能对上——比如module gitlab.example.com/myorg/lib要求GOPRIVATE至少含gitlab.example.com/myorg - 如果你用了
replace指向本地路径（如replace example.com/foo => ../foo），Go 仍会对原始 module path 校验 checksum；此时需确保GOPRIVATE覆盖的是example.com/foo，而非本地路径 - 运行
go list -m all可看到实际解析出的 module path，比go.mod更真实
go get 和 go build 对 GOPRIVATE 的行为差异
go get 默认走 proxy + checksum database，而 go build 在已有依赖时可能绕过下载，导致问题只在首次拉依赖时暴露。
-
go get -u会强制刷新依赖，更容易触发 checksum mismatch；生产环境建议避免无条件-u，改用go get example.com/private@v1.2.3显式指定版本 -
go build如果本地pkg/mod里已有模块缓存，可能不校验（尤其当GOSUMDB=off临时关闭时），但这不是稳定行为——别依赖它 - 真正可靠的组合是：
GOPRIVATE正确设置 +GOSUMDB=off（仅限完全离线或私有环境），否则仍推荐保留GOSUMDB并靠GOPRIVATE精准排除
CI 构建中 GOPRIVATE 失效的典型场景
Docker 构建或 GitHub Actions 中，环境变量常被覆盖或未传递到子 shell，导致 Go 命令运行时看不到 GOPRIVATE。
立即学习“go语言免费学习笔记（深入）”；
- Dockerfile 中必须用
ENV GOPRIVATE=gitlab.example.com/myorg，不能只靠RUN export GOPRIVATE=...（后者只在当前 RUN 生效） - GitHub Actions 的
env:要写在 job 级或 step 级，且确保所有run:步骤都继承该环境（有些自定义 action 会清空环境） - 使用
go mod download预热依赖时，若没设GOPRIVATE，缓存里会存下带 checksum 的记录，后续go build即使补设变量也无效——得先go clean -modcache - 私有 Git 仓库若用 SSH 地址（如
git@gitlab.example.com:myorg/pkg.git），模块路径仍以 HTTPS 形式（gitlab.example.com/myorg/pkg）参与GOPRIVATE匹配，不用改成git@前缀
最容易被忽略的是模块路径的“隐式推导”——比如 import "gitlab.example.com/myorg/pkg" 时，Go 会按该字符串去匹配 GOPRIVATE，而不是按 Git clone URL 推断。哪怕你用 HTTPS 克隆，只要 import 路径写成 gitlab.example.com/myorg/pkg，GOPRIVATE 就必须对应这个字符串。
