Golang 模块版本管理与语义版本控制详解

语义版本控制（SemVer）

Go 模块版本

模块版本的选择和升级

go.mod 文件

版本管理最佳实践

小结

在 Golang 中，模块（module）是 Go 1.11 版本引入的依赖管理系统，帮助开发者管理项目的依赖。在 Go 模块推出之前，开发者通常使用 GOPATH 和 vendor 目录来管理项目的依赖。但是，这种方法存在一些问题，如依赖管理不严格、版本控制不方便等。Go 模块的出现解决了这些问题，使得依赖管理变得更加简单和高效。

Go 模块的版本管理是基于语义版本控制（Semantic Versioning，简称 SemVer）的。在深入讨论 Go 模块版本之前，需要先理解语义版本控制的基本概念。

语义版本控制（SemVer）

语义版本控制是一个前后向兼容的版本命名系统，遵循 MAJOR.MINOR.PATCH 的格式，其中：

MAJOR（主版本号），版本号在做了不兼容的 API 修改时递增。
MINOR （次版本号），版本号在添加了向下兼容的新功能时递增。
PATCH （修订号），版本号在做了向下兼容的问题修正时递增。

此外，预发布版本可以通过添加连字符和一系列点分隔的标识符来表示，例如 1.0.0-alpha 或 1.0.0-rc.1。构建元数据可以通过添加加号和一系列点分隔的标识符来表示，例如 1.0.0+20130313144700。

Go 模块版本

在 Golang 中，模块的版本号反映了模块的变更情况。Go 模块系统要求公共的 Go 模块必须遵循语义版本控制规则：

当模块的公共 API 发生变更时，版本号也需要进行相应变更。当这些变更是向后不兼容的，必须增加 MAJOR 版本号。
v0 和 v1 版本，v0 版本通常表示开发初期，API 可能会频繁变更，不保证稳定性。v1 版本表示 API 的第一个稳定版本，任何新增的功能都不应该破坏现有的 API。
v2 及以上版本模块路径必须在路径的最后加上 /vN，其中 N 是主版本号。例如，如果模块名为 github.com/example/mod，那么 v2 版本或更高版本的模块路径应该是 github.com/example/mod/v2。
预发布版本和构建元数据，预发布版本和构建元数据遵循 SemVer的规则，但在Go模块中使用较少。预发布版本可以用于在正式发布之前测试模块的新版本。
伪版本，伪版本（pseudo-versions）是 Go 模块用来指代没有明确版本号的模块版本的方法，通常用于依赖特定的提交或者仓库中还没有标记正式版本号的代码。伪版本号的格式通常是 v0.0.0-yyyymmddhhmmss-abcdefabcdef，其中时间戳代表了特定的提交时间，abcdefabcdef 是该次提交的 git commit hash 的前12位。