Go Modules 详解与基本操作

发布时间：2022-07-16 11:27:18 所属栏目：云计算来源：互联网

导读：1 介绍 Go 自 1.11 以来，包含对 Module 版本的支持。初始原型 vgo 于 2018 年 2 月宣布。2018 年 7 月，Module 版本进入 Go 代码仓库主分支。 Go 1.11 和 1.12 包含对 Go Modules 的初步支持，Go 的新依赖项管理系统使依赖关系版本信息更加明确且更易于管理

　　1   介绍
　　Go 自 1.11 以来，包含对 Module 版本的支持。初始原型 vgo 于 2018 年 2 月宣布。2018 年 7 月，Module 版本进入 Go 代码仓库主分支。

　　Go 1.11 和 1.12 包含对 Go Modules 的初步支持，Go 的新依赖项管理系统使依赖关系版本信息更加明确且更易于管理。

　　Go Modules 介绍与基本操作

　　Module 是存储在文件树中的 Go 包的集合，其根目录有 go.mod 文件。go.mod 文件定义了 Module 的模块路径，该路径也是用于根目录的导入路径，以及其依赖项要求，这些依赖项要求是成功构建所需的其他模块。每个依赖项要求都编写为模块路径和特定的语义版本。

　　自 Go 1.11 起，可以显式启用模块模式（通过设置 GO111MODULE=on），go 命令允许在当前目录或任何父目录具有 go.mod 文件时使用模块模式，前提是该目录位于 $GOPATH/src 之外。（$GOPATH/src 内部，为了兼容性，go 命令仍以旧的 GOPATH 模式运行，即使找到 go.mod 文件。

　　在 Go 1.13，无需显式设置启用模块模式，只需设置 GO111MODULE=auto，如果发现任何 go.mod，即使在 GOPATH 内部，也表示启用模块模式。（在 Go 1.13 之前，GO111MODULE=auto 永远不会在 GOPATH 内启用模块模式）。

　　自 Go 1.14 以来，模块支持被视为可供生产环境使用，鼓励所有用户从其他依赖管理系统迁移到 Module。并且改回需显式设置启用模块模式（通过设置 GO111MODULE=on），如果不存在 go.mod 文件，大多数模块命令的功能更有限。

　　在 Go 1.15，可以通过 GOMODCACHE 环境变量设置模块缓存的位置。GOMODCACHE 的默认值是 GOPATH[0]/pkg/mod，可以在此更改模块缓存的位置。

　　本文将学习使用模块开发 Go 代码时出现的一系列基本操作，示例假定在 Linux 系统中 gopher 用户的家目录。

　　 2   创建一个新 Module
　　在 $GOPATH/src 外的任何位置，创建一个新的空目录，进入新创建的目录，创建一个新的源码文件：hello.go。

　　Go Modules 介绍与基本操作

　　再创建一个测试源码文件：hello_test.go。

　　Go Modules 介绍与基本操作

　　此时，目录包含包，但不包含模块，因为没有 go.mod 文件。如果我们在 /home/gopher/hello 目录去运行测试命令 go test，我们将看到：

　　Go Modules 介绍与基本操作

　　因为我们在 $GOPATH 之外，并且在任何模块之外的目录运行，go 命令不知道当前目录的导入路径，根据目录名称组成一个假的导入路径：_/home/gopher/hello。

　　让我们使用 go mod init 使当前目录成为模块的根目录，然后重试测试：

　　Go Modules 介绍与基本操作

　　祝贺！您已经编写并测试了第一个模块。go mod init 命令写了一个 go.mod 文件：

　　Go Modules 介绍与基本操作

　　go.mod 文件仅出现在模块的根目录中。子目录中的包具有导入路径，包括模块路径和子目录路径。例如，如果我们创建了一个子目录 world，我们不需要（也不想）运行 go mod init。包将自动识别为该模块 example.com/hello 的一部分，导入路径 example.com/hello/world。

　　 3   添加依赖项
　　Go modules 的主要目的是改进使用其他开发人员编写的代码（即添加依赖项）的体验。

　　让我们更新我们的 hello.go 导入 rsc.io/quote 并用它来实现函数 Hello：

　　Go Modules 介绍与基本操作

　　现在让我们再次运行 go test：

　　Go Modules 介绍与基本操作

　　go test 命令使用 go.mod 文件中列出的特定依赖项模块版本解析导入。当它遇到 go.mod 文件中任何模块未提供的包的导入时，go 命令会自动通过「最新版本」来备份包含该包的模块并将其添加到 go.mod。「最新」定义为最新的标记稳定（非预发行）版本，或者最新的标记预发行版本，或者最新的未标记版本。

　　在我们的示例中，go test 导入 rsc.io/quote 模块的最新版本 rsc.io/quote v1.5.2。

　　它还下载了两个间接依赖项，

　　rsc.io/sampler 和 golang.org/x/text。

　　仅将直接依赖项记录在 go.mod 文件中：

　　Go Modules 介绍与基本操作

　　再次运行 go test 命令，不会重复下载检索工作，因为 go.mod 现在是最新的，下载的模块在本地缓存目录中（$GOPATH[0]/pkg/mod）：

　　Go Modules 介绍与基本操作

　　请注意，虽然 go 命令使添加新的依赖项变得快速而简单，但它并非没有成本。您的模块现在实际上依赖于关键领域（如正确性、安全性和正确许可等）中的新依赖关系。

　　正如我们上面看到的，添加一个直接依赖关系通常也会带来其他间接依赖关系。命令 go list -m all 列出了当前模块及其所有依赖项：

　　Go Modules 介绍与基本操作

　　在 go 列表输出中，当前模块（也称为主模块）始终是第一行，后跟按模块路径排序的依赖项。

　　golang.org/x/text 版本 v0.0.0-20170915032832-14c0d48ead0c 是伪版本的示例，这是特定未标记提交的命令版本语法。

　　除了 go.mod 之外，go 命令还维护一个名为 go.sum 的文件，其中包含特定模块版本内容的预期加密哈希：

　　Go Modules 介绍与基本操作

　　go 命令使用 go.sum 文件来确保这些模块的未来下载检索与第一次下载相同的位，以确保项目所依赖的模块不会意外更改，无论是出于恶意、意外还是其他原因。go. mod 和 go. sum 都应签入版本控制。

　　 4   升级依赖项
　　使用 Go modules，版本使用语义版本标记进行引用。语义版本由三个部分组成：主要版本、次要版本和修补程序版本。例如，对于 v0.1.2，主要版本为 0，次要版本为 1，修补程序版本为 2。让我们演练几个次要版本升级。

　　从 go list -m all的输出中，我们可以看到我们使用的是未标记的 golang.org/x/text。让我们升级到最新的标记版本，并测试一切仍然有效：

　　Go Modules 介绍与基本操作

　　运行成功，让我们再看看 go list -m all 和 go.mod 文件：

　　Go Modules 介绍与基本操作

　　golang.org/x/text 已升级到最新的标记版本（v0.3.0）。go.mod 文件已更新，指定 v0.3.0。注释「indirect」指示依赖项不直接由此模块使用，仅由其他模块依赖项间接使用。

（编辑：我爱故事小小网_铜陵站长网）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!

友普加入红帽CCSP 加快	云原生现代化正在兴盛
第一个全链路国产操作	Ubuntu Redis数据库发