配置Golang私有仓库需设置GOPRIVATE环境变量，使其匹配私有模块路径如git.example.com，避免通过公共代理下载；支持通配符*，优先级高于GOPROXY和GOSUMDB，配合.netrc处理认证，并确保子模块路径也被包含。
配置 Golang 私有仓库，核心在于使用
GOPRIVATE环境变量，告诉 Go 工具链哪些仓库是私有的，不需要通过公共代理（如
proxy.golang.org）去查找。
GOPRIVATE环境变量设置
GOPRIVATE环境变量是控制 Go 模块下载行为的关键。它定义了哪些模块路径应该被视为私有，这意味着 Go 工具链不会尝试通过公共代理或校验和数据库来获取它们。这对于企业内部的私有仓库至关重要，因为它们通常不希望其代码被外部访问。
为什么需要设置 GOPRIVATE？
假设你正在开发一个内部项目，依赖于公司私有 Gitlab 仓库中的模块。如果没有设置
GOPRIVATE，Go 工具链可能会尝试通过公共代理来查找这些模块，结果自然是找不到，导致构建失败。更糟糕的是，如果你的模块路径与公共仓库冲突，可能会意外地拉取到错误的模块。
立即学习“go语言免费学习笔记（深入）”；
如何设置 GOPRIVATE？
GOPRIVATE可以设置为一个逗号分隔的模块路径前缀列表。例如：
export GOPRIVATE="git.example.com,github.example.com/org"
这意味着所有以
git.example.com或
github.example.com/org开头的模块路径都将被视为私有。
更精细的控制可以使用通配符
*。例如：
export GOPRIVATE="*.example.com"
这将匹配所有以
.example.com结尾的域名，例如
git.example.com、
code.example.com等。
GOPRIVATE 的优先级和生效范围
GOPRIVATE环境变量的优先级高于
GOPROXY和
GOSUMDB。这意味着，如果一个模块路径匹配了
GOPRIVATE，Go 工具链将直接从源代码控制系统（如 Git）下载，而不会尝试通过代理或校验和数据库。
GOPRIVATE的生效范围取决于你如何设置它。你可以将其设置为全局环境变量（通过修改
~/.bashrc或
~/.zshrc），也可以在单个项目的
.env文件中设置，或者在运行
go命令时临时设置。
GOPRIVATE 与 .netrc 的关系
如果你的私有仓库需要身份验证，你可能需要使用
.netrc文件来存储你的用户名和密码。
.netrc文件允许你在命令行中自动提供身份验证信息，而无需每次都手动输入。
Go 工具链会自动读取
.netrc文件，并使用其中的身份验证信息来访问私有仓库。但是，需要注意的是，将用户名和密码存储在
.netrc文件中存在安全风险，因此请谨慎使用。
如何处理子模块依赖？
当你的私有模块依赖于其他私有子模块时，你需要确保
GOPRIVATE包含了所有相关的模块路径。否则，Go 工具链可能无法正确地解析依赖关系。
一种常见的做法是将
GOPRIVATE设置为包含所有可能的私有模块路径前缀。例如：
export GOPRIVATE="git.example.com,github.example.com/org,internal.example.com"
GOPRIVATE 与 vendor 目录
如果你使用
vendor目录来管理依赖，
GOPRIVATE仍然有效。Go 工具链会首先检查
vendor目录，如果找不到依赖，才会尝试通过
GOPROXY或直接从源代码控制系统下载。
因此，即使你使用了
vendor目录，仍然需要设置
GOPRIVATE，以确保 Go 工具链能够正确地找到你的私有模块。
GOPRIVATE 的一些常见问题
-
忘记设置 GOPRIVATE： 这是最常见的问题。确保你已经正确地设置了
GOPRIVATE
环境变量，并且包含了所有相关的模块路径。 -
GOPRIVATE 设置不正确： 仔细检查你的
GOPRIVATE
设置，确保它包含了正确的模块路径前缀。可以使用go env
命令来查看当前的 Go 环境变量设置。 -
身份验证问题： 如果你的私有仓库需要身份验证，请确保你已经正确地配置了
.netrc
文件，并且 Go 工具链能够访问它。 - 网络问题： 确保你的网络连接正常，并且能够访问你的私有仓库。
如何调试 GOPRIVATE 相关的问题？
当遇到与
GOPRIVATE相关的问题时，可以使用
go get -v命令来查看详细的下载日志。这将显示 Go 工具链正在尝试从哪些 URL 下载模块，以及是否遇到了任何错误。
例如：
go get -v git.example.com/my-private-module
通过查看下载日志，你可以更容易地诊断问题，并确定是否需要修改
GOPRIVATE设置或
.netrc文件。
GOPRIVATE 的最佳实践
-
使用通配符： 尽可能使用通配符来简化
GOPRIVATE
设置。例如，*.example.com
比git.example.com,code.example.com,docs.example.com
更简洁。 -
保持 GOPRIVATE 的简洁性： 只包含必要的模块路径前缀。不要将不相关的模块路径添加到
GOPRIVATE
中，以避免不必要的性能损失。 -
使用 .env 文件： 对于单个项目，可以使用
.env
文件来设置GOPRIVATE
。这可以确保每个项目都有自己的GOPRIVATE
设置，而不会影响其他项目。 -
定期审查 GOPRIVATE： 随着项目的演进，你的私有模块路径可能会发生变化。定期审查
GOPRIVATE
设置，确保它仍然有效。
