在团队开发中,把通用逻辑抽成私有模块能显著提升复用率。Golang从1.13起完善了模块机制,配合环境变量即可安全地引用公司内网或第三方私有仓库的代码。下面说明具体做法。

一、创建私有模块
先在私有Git仓库(如 GitLab 或 GitHub Private)新建一个空仓库,例如 git@ipipp.com:team/utils.git,然后本地初始化模块:
// 初始化模块,模块路径使用仓库地址
go mod init ipipp.com/team/utils
// 写一个简单的工具函数
package utils
func Add(a, b int) int {
return a + b
}
提交代码并打上语义化标签,Golang 依赖管理通过标签识别版本:
git add . git commit -m "init utils" git tag v0.1.0 git push origin main --tags
二、配置私有仓库不走代理
Golang 默认会走 proxy.golang.org 下载模块,私有仓库必须声明为私有以避免泄露和拉取失败。使用 GOPRIVATE 环境变量:
// 设置私有前缀,支持通配符 go env -w GOPRIVATE=ipipp.com/team/* // 也可同时设置不走校验和数据库 go env -w GONOSUMDB=ipipp.com/team/*
这样当代码中 import ipipp.com/team/utils 时,Go 工具链会直接通过 git 协议拉取,而不请求公共代理。
三、处理仓库鉴权
私有仓库需要身份凭证。推荐使用个人访问令牌(PAT)代替密码,并在 Git 配置中替换:
// 将 ssh 或 https 地址统一改为带令牌的 https git config --global url."https://<token>@ipipp.com/".insteadOf "git@ipipp.com:"
如果使用 SSH 密钥且仓库支持,只需确保 ~/.ssh/id_rsa 有拉取权限即可,无需额外配置。
四、在项目中引用私有模块
业务项目里添加依赖并拉取:
// 在主模块中引入
import (
"ipipp.com/team/utils"
)
func main() {
println(utils.Add(1, 2))
}
// 自动写入 go.mod 并下载 go mod tidy
常见问题对照表
| 现象 | 原因 | 解决办法 |
|---|---|---|
| 404 Not Found | GOPRIVATE 未配置走了代理 | 设置 GOPRIVATE 环境变量 |
| unknown revision | 标签未推送或命名不规范 | 推送 vX.Y.Z 格式标签 |
| permission denied | Git 凭证无效 | 配置 PAT 或 SSH 密钥 |
五、小结
使用 Golang 管理私有模块核心就是:用仓库地址作为模块路径、通过 GOPRIVATE 避开代理、用 Git 凭证完成鉴权。掌握这几步后,内部依赖就能像公开库一样简洁地出现在 go.mod 中,提升团队协作效率。