Golang项目中如何轻松实现私有仓库pkg包的引入

在企业内部创建一个公共的Golang模块工程可以帮助提高代码复用性和开发效率。本文将从如何创建一个公共的Golang工程开始，指导你一步步创建它、并引入到你的工程中。

1、公共模块规范

下面是一个简单的步骤指南来创建这样一个公共模块项目。

创建版本控制仓库：使用版本控制工具（如Git）创建一个新的代码仓库，用于管理该公共模块工程的代码。

项目结构：定义好项目的结构，使其易于理解和使用。一个常见的Golang项目结构如下：

my-module/
   |- README.md        # 项目文档和说明
   |- go.mod           # Go模块定义文件
   |- go.sum           # Go模块的依赖版本文件
   |- cmd/             # 命令行应用程序目录（如果有的话）
   |- pkg/             # 项目的库代码目录
   |- internal/        # 内部库代码目录，不对外公开
   |- examples/        # 示例代码目录
   |- tests/           # 单元测试和集成测试目录

1. Go模块初始化：进入项目根目录，运行 go mod init 来初始化 Go 模块。模块名称应该是该模块工程的唯一标识符。

2. 编写代码：在 pkg/ 目录下编写公共的Golang库代码。这些代码应该是可复用的，不与具体应用逻辑绑定。

3. 文档和注释：对于公共模块，清晰的文档和注释是非常重要的。确保每个公共函数和类型都有良好的注释，方便其他开发人员理解和使用。

4. 示例代码：在 examples/ 目录下提供一些简单的示例代码，展示如何使用这个公共模块。

5. 单元测试：编写完整的单元测试和集成测试，保证模块的正确性和稳定性。测试代码放在 tests/ 目录下。

6. 版本管理：在Go中，版本管理使用Go Modules。当你的模块准备发布新版本时，确保适当地更新go.mod文件，并通过 go get @ 或 go mod tidy 来更新依赖关系。

7. 持续集成：将公共模块纳入到企业的持续集成流程中，确保每次修改都通过了测试，并符合质量标准。

8. 发布和文档：根据企业内部的发布流程，发布新的版本，并及时更新项目文档，方便其他开发人员使用。

以上是一个基本的指南来创建企业内部的Golang公共模块工程，可根据实现项目灵活调整。记得在开发过程中关注代码质量和安全性，并积极倾听来自其他开发人员的反馈，不断改进和优化模块。

2、如何引入公共模块

在Go中引入私有Git仓库的包可以通过在 go.mod 文件中添加 replace 或 require 语句来实现，具体取决于你的使用场景。以下是引入私有Git仓库包的三种常见方法。

在下述前两种方法中，你需要将 github.com/yourusername/yourprivatepkg 替换为你私有Git仓库的实际路径，然后根据需要设置路径或版本号。

完成后，运行 go mod tidy 命令来更新依赖。Go会自动下载和管理你的私有Git仓库包。

2.1 私有项目的路径替换

使用 replace 语句实现。

如果你希望在开发过程中使用本地路径或其他方式替代私有Git仓库，可以使用 replace 语句。这样可以方便地在不同环境中进行开发和测试。

如果私有项目 A 依赖另一个私有项目 B，且通过 go get 无法获取权限，可以采用 replace 方式。

在你的项目的 go.mod 文件中添加类似如下的 replace 语句，将私有Git仓库的路径替换为本地路径或其他路径：

replace github.com/yourusername/yourprivatepkg => /path/to/local/repo

或者，你可以使用相对路径：

replace github.com/yourusername/yourprivatepkg => ../path/to/local/repo

2.2 go mod私有项目的访问

使用 require 语句实现。

如果你想直接从私有Git仓库获取包并将其添加到项目依赖中，可以使用 require 语句。

在你的项目的 go.mod 文件中添加类似如下的 require 语句，将私有Git仓库的路径和版本号添加到依赖中：

require github.com/yourusername/yourprivatepkg v1.0.0

要实现上述方式，需要额外的配置，确保能够正常 go get 私有Git仓库的工程。

1. 设置 Go GOPRIVATE 变量

   # 配置多个私有项目地址
   go env -w GOPRIVATE="gitlab.example.com"
   # 其中gitee.com/user 是你的个人账户所在地址
   

   • 默认情况下，如果设置GOPRIVATE，会自动设置GONOPROXY和GONOSUMDB配置；

   • Golang项目非代理NOPROXY配置
     如果设置GONOPROXY和GONOSUMDB均为none，意味着所有module，不管是公共的还是私有的，都要经过proxy下载，经过sumdb验证。

2. 私有仓库的请求认证

   方法一：在请求URL中嵌入认证信息

   git config --global url."https://${user}:${password}@gitlab.example.com".insteadOf "https://gitlab.example.com"
   

   Git全局配置查看和删除:

   #查看git全局配置
   git config --global -l
   # 删除url路径替换, 或是修改${GitProject}/.git/config文件中对应url
   git config --global --unset url."[email protected]".insteadOf
   

   方法二：使用SSH替换HTTPS进行认证

   git config --global url."[email protected]".insteadOf "https://gitlab.example.com"
   

3. Golang私有项目的http访问

   如果私有库不支持https协议，会报如下的错误。这是因为Go更新依赖时，会强制校验CA证书来确保依赖库的安全性。

   go: gitee.com/modules/[email protected]: unrecognized import path "gitee.com/modules/project": https fetch: Get "https://gitee.com/modules/project?go-get=1": dial tcp 123.123.123:443: connect: connection refused
   

   如果私有库不支持https协议，还需要go配置参数或环境变量，使其使用http方式访问。

   方法一：go get -insecure

   使用 go get -insecure，这种方式不推荐，原因如下：

   • 添加 `-insecure`` 参数，即表示更新依赖时可以不去校验CA证书，但是这会带来一个问题：范围无法界定(overkill)，所有与要更新依赖相关联的依赖，均不会去做校验，可能会意外更新到不安全的依赖。

   • -insecure 仅支持 go get 命令，不支持 go mod 命令，因此使用 go mod 命令时是无法更新不支持https协议的私有库的。

   方法二：GOINSECURE

   添加 GOINSECURE 参数，推荐这种方式。

   • 在Go 1.14 中增加了新的环境变量，用于指定哪些域名下的仓库不去校验 CA 证书。

   • 使用方式同 GOINSECURE 类似 go env -w GOINSECURE=gitlab.example.com。

2.3 git 子模块（推荐）

在 Go 中，你可以使用 Git 子模块的方式引用私有的公共模块工程，以便在你的项目中使用。

1. 创建 Git 子模块

   在你的项目中，使用以下命令添加 Git 子模块，将私有的公共模块工程作为子模块引入：

   git submodule add <repository-url> path/to/submodule
   

   其中 是你私有模块工程的 Git 仓库 URL，path/to/submodule 是子模块在你的项目中的路径。

2. 配置认证

   如果你的私有模块工程需要身份验证，你可能需要在执行 go get 或 go mod 时提供适当的认证凭证。这可能包括用户名、密码、Personal Access Token（如果使用 GitLab）等。

3. 使用子模块的包

   在你的项目中，可以通过 import 语句引入子模块的包，然后在代码中使用这些包。

   import (
       "your/repo/path/to/submodule/package"
   )
   
   func main() {
       // 使用子模块的包
       submodulepackage.DoSomething()
   }
   

4. 使用 Go Modules 进行版本管理

   确保你的项目启用了 Go Modules，并在 go.mod 文件中添加了子模块的引用。

   go mod edit -replace=example.com/submodule=path/to/submodule
   

5. 更新子模块

   如果子模块的工程代码发生变化，你可以进入子模块目录，使用 git pull 更新子模块的代码。然后在你的项目根目录使用 go mod tidy 更新模块依赖。

3、总结

条条道路通罗马，技术更是如此。

具体选择那种取决于你的实际环境、实际场景，这里只提供一个思路、方向供大家参考。

---

参考文章：

1. Go Mod引用私有库
2. 怎么让Go Modules使用私有依赖模块
3. Git: submodule 子模块简明教程