Go私有模块仓库必须设置GOPRIVATE环境变量以绕过公共代理和校验，否则go get会失败；需配置私有服务响应@v/list等HTTP路径；replace仅限本地开发，不可用于CI或发布。
Go私有模块仓库必须设置 GOPRIVATE
不设 GOPRIVATE，go get 会默认走公共代理（如 proxy.golang.org）并校验 checksum，导致私有域名模块拉取失败或返回 403/404。这个环境变量是绕过代理和校验的开关，不是可选项。
设置方式（推荐全局生效）：
export GOPRIVATE="git.example.com,github.company.com/internal"
- 支持通配符：
*和**（如git.example.com/*），但不支持正则 - 多个域名用逗号分隔，**不能有空格**
- 若用
go env -w GOPRIVATE=...，注意 Windows PowerShell 里逗号需引号包裹 - CI 环境中也要显式注入该变量，否则构建会失败
私有仓库需提供符合 Go Modules 协议的版本响应
Go 客户端在拉取模块时，会向 https://<domain>/<module-path>/@v/list、/@v/vX.Y.Z.info、/@v/vX.Y.Z.mod、/@v/vX.Y.Z.zip 发起请求。你的私有服务（如 Nexus、JFrog Artifactory、或自建的 go.dev-style 服务）必须能响应这些路径。
常见错误现象：
立即学习“go语言免费学习笔记（深入）”；
go get: module example.com/mylib: reading example.com/mylib/@v/list: 404 Not Found-
verifying example.com/mylib@v1.2.3: example.com/mylib@v1.2.3: reading https://proxy.golang.org/example.com/mylib/@v/v1.2.3.info: 404 Not Found（说明GOPRIVATE没生效或没覆盖到）
验证方法：手动 curl 对应 URL，确认返回内容格式正确（@v/list 应为纯文本版本列表，每行一个语义化版本）。
使用 replace 仅适合本地开发，不可用于 CI 或发布
go.mod 中的 replace 是临时重写模块路径的机制，常被误当作私有模块方案：
replace example.com/mylib => ../mylib
- 它只影响当前 module 的构建，不会改变
go.sum中原始模块的 checksum 记录 - CI 构建时工作目录结构不同，
../mylib路径大概率不存在，直接报错 - 无法被下游 module 复用 ——
replace不传递，别人go get你的模块时仍会尝试拉取原始地址 - 真正上线前必须删掉
replace，改用真实私有仓库地址 + 正确GOPRIVATE
模块路径与 Git 仓库地址不必完全一致，但需可推导
Go 不强制要求 module example.com/mylib 必须托管在 https://example.com/mylib。只要 HTTP 服务能按路径映射到对应版本文件即可。例如：
- 模块声明为
module git.example.com/team/proj - 实际 Git 仓库地址是
ssh://git@git.example.com:2222/team/proj.git - HTTP 服务将
/team/proj/@v/list映射到该仓库的 tags 解析结果
关键点在于：客户端发起的 HTTP 请求路径，和服务端能响应的路径之间要有明确映射关系。很多自建方案失败，是因为只搭了 Git 服务，却没实现 Go Modules 所需的 HTTP 接口层。
如果用 Nexus Repository Manager，需启用 Go Proxy 和 Hosted 类型仓库，并确保路由规则匹配模块路径前缀；如果用 Artifactory，要开启 Go Registry 功能并绑定虚拟仓库。
