Golang私有模块仓库搭建指南

欢迎各位小伙伴来到golang学习网，相聚于此都是缘哈哈哈！今天我给大家带来《Golang私有module仓库搭建教程》，这篇文章主要讲到等等知识，如果你对Golang相关的知识非常感兴趣或者正在自学，都可以关注我，我会持续更新相关文章！当然，有什么建议也欢迎在评论留言提出！一起学习！

配置私有module需设置GOPRIVATE环境变量，如export GOPRIVATE=git.company.com；确保Git认证（SSH或HTTPS+Token）；模块路径与仓库一致；使用go get通过完整路径引入；可选配置GONOSUMDB跳过校验。

在使用 Golang 开发项目时，如果需要引用公司内部或私有的 module，不能像公开模块那样直接通过 go get 从公共仓库（如 GitHub、GitLab）拉取。此时就需要配置私有 module 仓库，让 Go 工具链知道如何正确获取这些模块。以下是完整的配置步骤。

1. 设置 GOPRIVATE 环境变量

为了避免 Go 在访问私有仓库时尝试通过公共代理（如 proxy.golang.org）下载模块，需要设置 GOPRIVATE 环境变量，告诉 Go 哪些模块是私有的，不应经过代理或校验 checksum。

export GOPRIVATE=git.company.com/internal/lib
# 或者支持多个域名
export GOPRIVATE=git.company.com,gitlab.mycompany.com

也可以将该配置写入 shell 配置文件（如 .zshrc 或 .bashrc），避免每次重新设置。

2. 配置 Git 认证信息

Go 下载私有模块依赖于 Git，因此必须确保 Git 能够正确认证并访问你的私有仓库。常用方式有 SSH 和 HTTPS + Token 两种。

• 使用 SSH 方式（推荐）：
  • 确保本地已生成 SSH 密钥，并添加到 Git 服务器（如 GitLab、GitHub、自建 Git 服务）。
  • 模块导入路径应使用 SSH 格式，例如：git@company.com:group/module.git
  • Go 会自动调用 ssh-agent 完成认证。
• 使用 HTTPS + Personal Access Token：
  • 若使用 HTTPS 地址（如 https://git.company.com/group/module），需配置凭据存储。
  • 可使用 Git 凭据助手保存用户名和 Token：

  git config --global credential.helper store
  # 第一次 git pull 时输入用户名和 Token，会被记住
      

3. 正确声明模块路径

在私有项目中，go.mod 文件里的模块名必须与实际仓库路径一致。

例如，你的 Git 仓库地址为 git@company.com:backend/user-service.git，则 go.mod 应为：

module git.company.com/backend/user-service
go 1.19

其他项目引用它时，也应使用相同路径：

import "git.company.com/backend/user-service/auth"

4. 使用 go get 引入私有模块

在项目中引入私有模块时，直接使用完整模块路径：

go get git.company.com/backend/user-service@v1.0.0

Go 会通过 Git 拉取代码，并根据 tag 解析版本。如果尚未发布 tag，也可使用 commit hash：

go get git.company.com/backend/user-service@8a5e1f3

5. （可选）配置 GONOSUMDB

除了 GOPRIVATE，你还可以使用 GONOSUMDB 来跳过特定仓库的 checksum 验证：

export GONOSUMDB=git.company.com,github.com/myprivatefork

但通常只需设置 GOPRIVATE 即可，因为它已隐式包含 GONOSUMDB 的行为。

基本上就这些。只要确保环境变量设置正确、Git 认证可用、模块路径匹配，Go 就能顺利拉取私有 module。不复杂但容易忽略细节。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang私有模块仓库搭建指南》文章吧，也可关注golang学习网公众号了解相关技术文章。