共计 3183 个字符，预计需要花费 8 分钟才能阅读完成。
点击一键订阅《云荐大咖》专栏，获取官网举荐精品内容，学技术不迷路！
Go 语言做开发时，门路是如何定义的？Go Mudules 又为此带来了哪些扭转？本文将会全面介绍 Go modules 六大外围概念，包含了设计理念与兼容性准则等，把握这些技术点对于治理和保护 Go 模块有重要价值。
上一篇文章中，笔者介绍了如何以经典的 hello world 为例创立一个 Go module 模块，须要阐明的是一个模块中是能够蕴含多个包（package）的，它们是能够被一起公布、打包、版本化的。同时，Go Modules 也能够通过版本管理系统（github、gitlab）或者 goproxy 代理进行下载。在应用 Go Modules 之前，倡议大家弄清楚非亲非故的六大外围概念，以不便大家在前期的开发、应用过程中了解更加深刻。
咱们在应用 Go 语言做开发时常常会遇到像“example.com/test”或者“example.com/test/pkg/log”这样的门路，这些门路到底是怎么定义的，两者中存在什么关系，在 Go Modules 中又扮演着怎么的角色呢？Go Modules 的引入对已有的包又引入了哪些新的概念，它们是如何合作的？对兼容性提出了哪些新的要求呢？让咱们一起来看一下。
一：模块门路（Module Path）
Go 应用“module path”来辨别不同的 module 模块，它在 go.mod 文件中被定义，这个文件中还蕴含了这个模块编译所需的其余依赖。如果一个目录中蕴含了 go.mod 文件，那么这个目录就是这个 Go 模块的根目录了。
另外，还要介绍下包（package）这个概念，它在 Go Modules 呈现之前就曾经存在了。Go 模块中的“包 (package)”是处于同一目录中的一些源代码文件的汇合，这些文件将被编译在一起。“包门路（package path）”是模块门路和子目录（模块根目录的相对路径）的组合。举个例子，在模块“golang.org/x/net”下的 html 目录中有个包，这个包的门路是“golang.org/x/net/html”。
总结下来就是：一个代码仓库能够蕴含多个 Go 模块，一个 Go 模块能够蕴含多个 Go 包。
模块门路是一个 Go 模块的标准名称，用于辨别不通的模块。同时他还是该模块下 Go 包的门路前缀。实践上，模块门路应该至多蕴含两个要害信息：
模块的作用
哪里获取该模块
二：版本号与兼容性准则
版本号相当于是一个模块的只读快照，它能够是正式的公布版本，也能够是预公布版本。每个版本都以字母 v 结尾，后跟一个语义版本，例如 v1.0.0。
总而言之，语义版本由三个由点分隔的非负整数（次要版本、主要版本和补丁版本，从左到右）组成。补丁版本后能够跟一个以连字符结尾的可选预公布字符串。预公布字符串或补丁版本后能够跟一个以加号结尾的构建元数据字符串。例如，v0.0.0、v1.12.134、v8.0.5-pre、v2.0.9+meta 等都是无效版本。
版本号中的信息代表了这个版本是否是一个稳定版，是否放弃了与之前版本的兼容性。
当保护的模块产生了一些不兼容变更，比方批改了内部可调用的接口或者函数时，须要对主版本号进行递增，并且将次版本号和补丁版本号置为零。比方在模块中移除了一个包。
在模块中增加一些新的函数或者接口，并没有影响模块的兼容性时，须要对次版本号进行递增，并且将补丁版本号置为零。
当修复了一些 bug 或者进行了一些优化时，只须要对补丁版本号进行递增就能够了，因为这些变更不会对曾经公开的接口进行变更。
预公布后缀代表了这个版本号是一个预公布版本。预公布版本号的排序会在正式版本号的后面。举个例子，v1.2.3-pre 会排列在 v1.2.3 后面。
元数据后缀会在版本比对中被疏忽，版本控制中的代码库会疏忽带有构建元数据的标签，但在 go.mod 文件中指定的版本中会保留构建元数据。如果一个模块还没有迁徙到 Go Modules 并且主版本号是 2 或者更高，+incompatible 后缀会被增加到版本号上。
如果一个版本的主版本号是 0 或者它有一个预公布版本后缀，那么这个版本被认为是一个不稳固版本。通常，不稳固版本不受兼容性限度的，举个例子，v0.2.0 可能和 v0.1.0 是不兼容的，v1.5.0-beta 可能和 v1.5.0 也是不兼容的。
Go 能够通过 tags、分支、和 commit 哈希值来获取模块，即便这些命名没有遵循这些规定。在主模块中，go 命令会主动的将这些 revision 转化为符合标准的版本号，其被称为伪版本号（pseudo-version）。举个例子，当执行上面的命令时：
go get -d golang.org/x/net@daa7c041
Go 会讲指定的 hash daa7c041 转化为一个伪版本号 v0.0.0-20191109021931-daa7c04131f5。在主模块之外须要标准版本，如果 go.mod 文件中呈现像 master 这样的非标准版本，go 命令会报错。
三：伪版本号
伪版本号是一种预公布版本号的格局，其中蕴含了指定的 commit hash 值。另外，对于没有打标签的代码库，也能够应用伪版本号来表明某个版本，它能够在正式公布某个版本之前不便的进行测试。举个例子，每个伪版本号都有三局部组成：
根本版本前缀（vX.0.0 或 vX.Y.Z-0），它要么源自修订版之前的语义版本标签，要么源自 vX.0.0（如果没有此类标签）。
工夫戳 (yyyymmddhhmmss)，这是创立 commit 的 UTC 工夫。在 Git 中，这是 commit 提交工夫。
commit 标识符 (abcdefabcdef)，它是提交 commit 哈希的 12 个字符的前缀，或者在 Subversion 中，是一个用零填充的订正号。
在这三个局部之下，又分为以下多种状况：
如果之前没有基版本，那么诸如 vX.0.0-yyyymmddhhmmss-abcdefabcdef 这样的伪版本号将被启用。主版本号 X 须要匹配模块的主版本号后缀。
如果之前的基版本号是一个像 vX.Y.Z-pre 这样的预公布版本，那么 vX.Y.Zpre.0.yyyymmddhhmmss-abcdefabcdef 将被采纳。
如果之前的基版本号是一个像 vX.Y.Z 这样的正式版本，那么 vX.Y.(Z+1)-0.yyyymmddhhmmss-abcdefabcdef 将被采纳，举个例子，如果基版本号是 v1.2.3，伪版本号可能是 v1.2.4-0.20191109021931-daa7c04131f5。
基于不同的根底版本号，多个伪版本号是有可能指向同一个 commit hash 的，在对一个低于曾经存在的伪版本号打标签时，这种状况就会产生。
下面介绍的这种伪版本号携带了两个十分有用的信息：
- 伪版本号会高于这些曾经存在的根底版本号，然而会低于前面生成的其余伪版本号。
- 有雷同根底版本前缀的伪版本按工夫程序排序。
伪版本号不须要手动指定。很多 Go 命令能够承受一个 commit hash 或者分支名，而后主动将其转化为一个伪版本号（或者一个标签，如果存在的话）。例如：
go get -d example.com/mod@master
go list -m -json example.com/mod@abcd1234
在本篇中，咱们介绍了模块门路、版本号与兼容性准则、伪版本号三大概念，而在下篇咱们将会持续介绍 Go Modules 外围概念，包含主版本号后缀、解析包门路到模块门路的流程、go.mod 文件，敬请期待。另外，腾讯云 goproxy 企业版曾经产品化，须要理解的同学能够点击这里。
李保坤往期精彩文章举荐：Go 语言从新开始，Go Modules 的前世今生与根本应用
《云荐大咖》是腾讯云加社区精品内容专栏。云荐官特邀行业佼者，聚焦于前沿技术的落地及实践实际之上，继续为您解读云时代热点技术、摸索行业倒退新机。点击一键订阅，咱们将为你定期推送精品内容。
