23 包管理与模块之版本控制与发布

在前一篇中，我们详细介绍了如何使用 go mod 来管理 Go 项目的依赖。通过 go mod，我们能够轻松地添加、更新和删除依赖项，以及处理版本冲突。而在本篇中，我们将深入探讨如何进行版本控制与发布，这是 Go 语言包管理的一个重要方面。

版本控制

在 Go 语言中，模块的版本控制主要依赖于语义版本控制（Semantic Versioning）。语义版本通常由三个数字组成，形式为 MAJOR.MINOR.PATCH：

• MAJOR：当你进行不兼容的 API 改动时增加此数字。
• MINOR：当你进行向下兼容的功能性新增时增加此数字。
• PATCH：当你进行向下兼容的问题修正时增加此数字。

例如，版本 2.1.3 表示该包的主版本是 2，次版本是 1，补丁版本是 3。

创建与修改版本

在开发过程中，如何创建和发布新的模块版本呢？我们主要有以下几步：

1. 修改模块代码：在你的模块代码中进行必要的修改。

2. 更新版本号：修改 go.mod 文件中的版本号，例如：

   module example.com/mylib/v2
   
   go 1.18

   将 module 声明中的版本号从 v1 更改为 v2。

3. 提交代码：将修改提交到版本控制系统（如 Git）。

4. 生成版本标签：使用 Git 命令生成标签，以便发布指定的版本：

   git tag v2.0.0
   git push origin v2.0.0

5. 发布模块：对于公开模块，使用 go get 命令可以安装特定版本：

   go get example.com/mylib/v2@v2.0.0

示例

假设我们有一个名为 mylib 的模块，当前版本为 v1.0.0。我们新增了一个功能，在代码中进行相应的修改并把版本提升至 v1.1.0。具体过程如下：

1. 修改代码，添加了新函数 NewFeature。

   package mylib
   
   func NewFeature() string {
       return "This is a new feature!"
   }

2. 更新 go.mod 文件：

   module example.com/mylib/v1
   
   go 1.18

3. 提交并打标签：

   git commit -am "Add new feature"
   git tag v1.1.0
   git push origin v1.1.0

4. 其他项目可以使用：

   go get example.com/mylib/v1@v1.1.0

发布模块

除了创建版本外，发布模块同样重要。在 Go 生态中，包的发布通常是通过对外托管的代码仓库（如 GitHub）来完成的。

公开仓库与私有仓库

• 公开仓库：如果你的模块是公开的，用户可以直接通过 go get 命令获取最新的版本。

• 私有仓库：对于私有仓库，用户需要设置合适的访问凭据，Go 语言也提供了一些工具（如 GOPRIVATE 环境变量）来处理私有包的获取。

发布到公共模块索引

一旦确定了版本，Go 语言的公共模块索引（如 https://pkg.go.dev/）可以帮助你传播和分享你的模块。通过标签与版本控制，其他开发者很容易找到并使用你的模块。

示例：私有包发布

如果你的模块是私有的，假设你在 GitHub 上托管了你的代码，你可能需要如下操作：

1. 在 go.mod 中指定私有模块的路径。

   module example.com/myprivatemodule

2. 设置 GOPRIVATE 环境变量，确保 Go 工具可以访问私有仓库：

   export GOPRIVATE=example.com

3. 使用 HTTPS URL 进行获取和版本控制。

结语

本篇介绍了 Go 语言的模块版本控制与发布的基本流程，涵盖了语义版本的升降、版本标签的使用以及如何处理私有与公共仓库。明白了这些概念与流程后，我们能更好地管理和发布我们的 Go 模块。下一篇我们将讨论如何管理私有包以便于团队协作与内部使用，让我们继续深入探索 Go 语言的模块化世界。