Go / 系统课时

配置 GOPRIVATE 匹配范围

配置 GOPRIVATE 匹配范围

企业内部模块通常有统一的域名或路径前缀。配置 GOPRIVATE 的关键不是记住一个固定值,而是准确描述哪些模块属于私有范围,让 Go 对这些模块采用不同的代理和校验行为。

学习目标

  • 能按企业域名或模块路径配置 GOPRIVATE
  • 理解逗号分隔的匹配模式如何覆盖多个私有模块
  • 能用 go env 验证配置是否已生效

先确定私有模块的路径规律

假设企业内部模块统一使用 git.corp.example.com,实际模块路径可能是:

git.corp.example.com/platform/logging
git.corp.example.com/team/order
git.corp.example.com/team/payment

这类路径都有共同的前缀,因此通常可以按企业域名设置一个范围,而不是逐个模块填写。

GOPRIVATE 是逗号分隔的模块路径匹配模式。例如:

bash
go env -w GOPRIVATE=git.corp.example.com

配置多个私有范围

当公司同时维护多个代码域名,可以使用逗号分隔多个模式:

bash
go env -w GOPRIVATE=git.corp.example.com,*.internal.example.net

这里的模式用于匹配模块路径。使用通配模式时,要按照 Go 模块路径的实际前缀设计,而不是把它当成正则表达式使用。

验证匹配范围

配置完成后,先检查 Go 当前保存的值:

bash
go env GOPRIVATE

预期输出:

text
git.corp.example.com,*.internal.example.net

再查看完整环境值时,可以使用:

bash
go env GOPRIVATE GOPROXY GONOPROXY GONOSUMDB

预期结果会显示当前的私有模块范围,以及相关代理和校验设置;具体内容取决于你本机此前的 Go 配置。

什么时候需要拆分范围

如果企业存在多个安全边界,例如一个域名承载源码仓库,另一个域名只承载公开镜像,可以拆成更精确的模式。判断标准是:哪些模块需要被 Go 当成私有模块处理,就只覆盖哪些路径。

不要把“公司拥有的域名”和“所有代码都不能公开”混为一谈。GOPRIVATE 描述的是模块的私有性范围,范围越精确,后续 GOPROXY、GONOPROXY 和 GONOSUMDB 的行为越容易控制。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

配置 GOPRIVATE 匹配范围

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通