在Golang项目开发中，使用私有模块可以有效复用内部公共代码，同时保障核心代码的安全性。私有模块通常存储在企业自建的Git仓库或者第三方私有仓库服务中，和公开模块的使用逻辑存在差异，需要针对性配置环境。
核心配置项说明
使用Golang私有模块前，需要先了解几个关键的go环境变量，这些变量决定了go命令拉取模块时的行为逻辑。
- GOPRIVATE：用于指定不需要走公共代理、不需要校验sum hash的模块路径前缀，私有模块路径需要添加到这个变量中。
- GONOPROXY：指定不需要通过代理拉取的模块路径，通常和GOPRIVATE配置一致即可。
- GONOSUMDB：指定不需要去公共sum验证库校验hash的模块路径，私有模块没有上传到公共sum库，需要配置这个变量。
基础配置步骤
1. 设置环境变量
假设你的私有模块路径前缀是git.ippipp.com/internal，可以通过以下命令设置环境变量，如果是临时生效可以直接在终端执行：
# 设置私有模块路径前缀 go env -w GOPRIVATE=git.ippipp.com/internal # 可选，设置不走代理 go env -w GONOPROXY=git.ippipp.com/internal # 可选，跳过sum校验 go env -w GONOSUMDB=git.ippipp.com/internal
如果需要永久生效，可以将配置写入shell配置文件，比如bash用户写入~/.bashrc，zsh用户写入~/.zshrc：
export GOPRIVATE=git.ippipp.com/internal export GONOPROXY=git.ippipp.com/internal export GONOSUMDB=git.ippipp.com/internal
2. 配置仓库访问权限
go命令拉取私有模块时，默认使用git的权限配置，需要确保当前环境有权限访问对应的私有仓库。如果是使用SSH方式访问，需要提前配置好SSH密钥，添加到仓库的部署密钥中。如果是使用HTTPS方式访问，可以配置git的credential helper存储账号密码，或者设置~/.netrc文件：
# ~/.netrc 文件内容示例，替换成实际的仓库地址和账号密码 machine git.ipipp.com login your_username password your_password
3. 引入私有模块
配置完成后，就可以在项目中正常引入私有模块了，和引入公开模块的操作一致：
# 初始化go mod（如果项目还没有初始化） go mod init your_project_name # 拉取私有模块，假设模块路径是git.ipipp.com/internal/utils，版本是v1.0.0 go get git.ipipp.com/internal/utils@v1.0.0
拉取成功后，go.mod文件会自动添加对应的依赖记录：
module your_project_name
go 1.21
require (
git.ipipp.com/internal/utils v1.0.0
)
常见使用场景示例
私有模块的代码引用
拉取完成后，就可以在代码中正常引用私有模块的导出内容：
package main
import (
"fmt"
// 引入私有模块
"git.ipipp.com/internal/utils"
)
func main() {
// 调用私有模块的导出函数
result := utils.Add(1, 2)
fmt.Println("计算结果:", result)
}
更新私有模块版本
如果私有模块发布了新版本，可以通过以下命令更新依赖：
# 更新到指定版本 go get git.ipipp.com/internal/utils@v1.1.0 # 更新到最新版本 go get git.ipipp.com/internal/utils@latest
常见问题与解决方案
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 拉取私有模块时提示404或者权限不足 | 环境变量GOPRIVATE没有配置正确，或者仓库访问权限不足 | 检查GOPRIVATE是否包含模块路径前缀，确认SSH密钥或者账号密码配置正确 |
| 拉取时提示sum验证失败 | GONOSUMDB没有配置，go命令尝试去公共sum库校验私有模块的hash | 将私有模块路径添加到GONOSUMDB环境变量中 |
| go get提示找不到模块 | 模块路径填写错误，或者模块没有打对应的版本tag | 确认模块路径和版本号正确，私有模块需要打git tag作为版本标识 |
注意事项
如果私有仓库使用的是自签名的SSL证书，可能需要额外配置git忽略证书校验，或者将证书添加到系统的信任证书列表中，避免拉取时出现证书错误。另外，GOPRIVATE支持配置多个路径，多个路径之间用英文逗号分隔即可，比如go env -w GOPRIVATE=git.ipipp.com/internal,git.ipipp.com/common。