导语 | 腾讯云加社区精品内容栏目《云荐大咖》，特邀行业佼者，聚焦前沿技术的落地与理论实践，持续为您解读云时代热点技术，探秘行业发展新机。

Go语言做开发时，路径是如何定义的？Go Mudules又为此带来了哪些改变？本文将会全面介绍Go modules六大核心概念，包括了设计理念与兼容性原则等，掌握这些技术点对于管理和维护Go模块有重要价值。

上一篇文章《Go语言重新开始，Go Modules的前世今生与基本使用》中，笔者介绍了如何以经典的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的引入对已有的包又引入了哪些新的概念，它们是如何协作的？对兼容性提出了哪些新的要求呢？让我们一起来看一下。

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.Z-pre.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@mastergo list -m -json example.com/mod@abcd1234

在本篇中，我们介绍了模块路径、版本号与兼容性原则、伪版本号三大概念，而在下篇我们将会继续介绍Go Modules核心概念，包括主版本号后缀、解析包路径到模块路径的流程、go.mod文件，敬请期待。另外，腾讯云 goproxy企业版已经产品化，需要了解的同学可以跳转↓↓

（https://goproxy.io/zh/docs/enterprise.html）

Go语言重新开始，Go Modules的前世今生与基本使用

聊聊代码质量-《学得会，抄得走的提升前端代码质量方法》前言

链路追踪（Tracing）的前世今生（上）

日均请求量1.6万亿次背后，DNSPod的秘密-国密DoH篇

👇戳「阅读原文」一键订阅《云荐大咖》专栏，看云端技术起落，听大咖指点迷津！云荐官将在每周五抽取部分订阅小伙伴，送出云加视频礼盒！