在Go项目开发中，使用私有仓库作为模块依赖是非常常见的需求，比如企业内部的公共工具库、业务组件库等都不会对外开放，需要单独配置才能让Go的模块系统正常识别和拉取这些私有模块。
核心配置原理
Go的模块拉取逻辑由go_mod相关的环境变量控制，默认情况下go get等命令会尝试从公共的模块镜像站拉取依赖，私有仓库不在公共镜像的覆盖范围内，因此需要通过配置告诉Go工具链哪些仓库是私有的，以及从哪里拉取这些私有仓库的内容。
基础配置步骤
1. 设置GOPRIVATE环境变量
GOPRIVATE环境变量用于指定哪些模块路径属于私有仓库，Go工具链遇到这些路径时会跳过公共镜像，直接从源仓库拉取。该变量支持通配符配置，多个路径用逗号分隔。
如果是临时配置，可以在当前终端执行以下命令：
# 配置单个私有仓库 export GOPRIVATE=git.ipipp.com/company/utils # 配置某个域名下的所有私有仓库 export GOPRIVATE=git.ipipp.com/* # 配置多个私有仓库 export GOPRIVATE=git.ipipp.com/company/utils,git.ipipp.com/company/component
如果需要永久生效，可以将上述命令添加到shell的配置文件（如~/.bashrc、~/.zshrc）中，执行source ~/.bashrc让配置生效。
2. 配置仓库认证信息
私有仓库通常需要身份认证，Go工具链支持通过Git的凭证配置来完成认证，也可以通过设置GIT_TERMINAL_PROMPT等环境变量适配不同的认证场景。
如果是使用SSH密钥认证，只需要确保本地已经生成了SSH密钥，并且将公钥添加到了私有仓库的账号中即可，Go拉取时会自动使用SSH协议完成认证。
如果是使用HTTPS协议认证，可以配置Git的凭证存储，避免每次拉取都输入账号密码：
# 配置Git凭证存储，长期保存账号密码 git config --global credential.helper store # 第一次拉取私有仓库时会提示输入账号密码，之后会自动保存
进阶配置场景
私有仓库使用自定义域名
如果私有仓库的访问地址和模块导入路径不一致，比如模块导入路径是company.com/utils，但实际仓库地址是git.ipipp.com/company/utils，可以通过设置GOPROXY和GOSUMDB配合处理：
# 关闭私有模块的校验和检查，避免因为私有模块不在公共校验库报错 export GOSUMDB=off # 如果私有仓库有专属的代理，也可以单独配置 export GOPROXY=https://proxy.golang.org,direct
本地开发私有模块调试
在开发私有模块的过程中，可能需要本地修改后让其他项目引用，此时可以使用go mod replace指令临时替换模块路径：
// 在项目的go.mod中添加replace指令，指向本地模块路径 replace company.com/utils => /local/path/to/utils
调试完成后删除replace指令，再使用正常的私有仓库路径拉取即可。
常见问题排查
- 拉取私有模块时提示404：检查GOPRIVATE是否包含了当前模块的路径，确认私有仓库地址是否正确，认证信息是否配置生效。
- 提示校验和错误：可以临时设置
export GOSUMDB=off关闭校验，或者将私有模块的校验和添加到项目的go.sum文件中。 - SSH连接超时：检查SSH密钥是否配置正确，私有仓库的SSH地址是否可以正常访问，防火墙是否拦截了SSH端口。
配置验证
完成配置后，可以通过以下命令验证私有模块是否可以正常拉取：
# 拉取私有模块 go get git.ipipp.com/company/utils@latest # 查看当前项目的依赖列表，确认私有模块已经正确引入 go mod graph | grep git.ipipp.com
如果命令执行没有报错，且能正常看到私有模块的信息，说明配置已经生效，后续就可以像使用公共模块一样使用私有仓库中的模块了。