忘掉GOPATH,迎接Go modules,进入Go项目依赖库版本管理新时代

栏目: Go · 发布时间: 5年前

内容简介:Go SDK 1.13测试版马上就要发布了。从此版本开始,Go modules依赖库版本管理特性将正式开始推荐使用。本文将解释一些和Go modules相关的一些命令和概念。Module(模块)定义为一些Go代码包的集合。通常体现为一个含有若干代码包的目录。每个模块可以发布一系列版本。版本号使用如果你所维护的某个模块尚未使用Go modules管理依赖,你可以打开一个命令行终端,进入此模块根目录,运行下面这条命令将此模块转换为一个使用Go modules管理依赖的模块。

Go SDK 1.13测试版马上就要发布了。从此版本开始,Go modules依赖库版本管理特性将正式开始推荐使用。本文将解释一些和Go modules相关的一些命令和概念。

Module(模块)定义为一些 Go 代码包的集合。通常体现为一个含有若干代码包的目录。每个模块可以发布一系列版本。版本号使用 semver(语义化版本) 表示。一个模块可能依赖于其它若干模块;准确说来,是依赖于其它若干模块的各自的某个具体版本。每个模块可以在自己的根目录下的 go.mod 文件中指定其所依赖的各个模块的具体版本。

如果你所维护的某个模块尚未使用Go modules管理依赖,你可以打开一个命令行终端,进入此模块根目录,运行下面这条命令将此模块转换为一个使用Go modules管理依赖的模块。

go mod init host.prefex/mypkg

其中, host.prefex/mypkg 为其它包引入此模块中的包时的引入路径的前缀。常常地, host.prefexgithub.com 等源代码托管网站; mypkg 常为 user/project 这种形式。当然,你也可以将你自己的域名 my.website 用做引入路径的前缀( host.prefex )。但是这时如果不能从引入路径 my.website/mypkg 中判断出此代码包使用何种源代码版本管理工具(比如git/hg/svn等),则 my.website 网站必须响应 https://my.website/mypkg?go-get=1 HTTPS请求(HTTP也可以但不推荐),并在在HTML的返回体中的 <head> 部分包含一个 <meta> 标签来指名具体到哪里下载此模块。(本公众号将另开一篇文章详解自定义域名引入路径。)

当go.mod文件已经创建出来之后,我们可以在此文件中手动指定此模块所要依赖的其它模块和这些以来模块的版本号(版本号必须指定但可以使用伪版本号,比如 <v1.12.3>=v1.5.6latest 和分支名 master 等)。我们也可以运行go build和go test等命令来自动发现并且在 go.mod 文件中加入依赖模块和它们的具体版本。手动指定的伪模块版本号将被 go build 等命令更改为确切的版本号。其中

  • latest 伪版本号将被解读为最新正式发布版本,正式发布版本是标号为形如 vX.Y.Z 的语义化版本(semver, X / Y / Z 均为整数数字)。
  • 分支名伪版本号将被解读为指定分支的最新提交。
  • <v1.12.3 将被解读为 v1.12 系列版中最大的小于 v1.12.3 的版本。

当使用源代码版本管理 工具 时,一个tag的名称将被视为一个版本号。形如 v1.2.3-pre1 的预发布版本不属于正式版本。(关于模块的版本匹配规则,本公众号将另发一篇文章详述。)

go build 等命令将下载并缓存尚未缓存的依赖模块的版本代码,并将各个模块(包括直接和间接依赖)的哈希存储在 go.sum 文件(和 go.mod 文件处于同一目录)中。

在一个模块目录下运行 go get a.b.c/x/y@v1.2.3 将在此模块的 go.mod 文件中加入一个依赖。

默认情况下, go build 等命令将访问sumdb(Checksum Database,默认值为 https://sum.golang.org/ )验证各个直接或者间接依赖模块的哈希值是否和各个 go.sum 中记录的哈希值相匹配。如果不匹配,很可能某些环节出了问题(比如下载的模块代码被人恶意更改了)。(关于sumdb,本公众号将另发一篇文章详述。)

一般说来, go.mod 文件中只记录当前模块的直接依赖。每个依赖体现为一条 require 或者 replace 指令。比如

module my.website/cmd/myprogram

require github.com/boltdb/bolt v1.3.0
​
replace my.website/mypkg github.com/myname/myproject v1.0.0

其中的 replace 指令表示,当遇到引入路径前缀为 my.website/mypkg 的代码包时,真实的下载的代码包为处于路径 github.com/myname/myprojectv1.0.0 版本的模块下的相应代码包。

如果你的一个旧项目是使用其它流行第三方工具(比如deps和glide等)来管理包依赖的,则在此项目下运行 go mod init host.prefex/mypkg 命令将自动将此项目转换为一个使用 go modules 管理依赖的项目。

如果你的一个新项目需要依赖于一个当前正使用其它流行第三方工具来管理包依赖的库,则请到此库的根目录下运行以下 go mod init a.b/c 命令(引入路径可任意),然后将生成的 go.mod 中的所有 require 指令复制到你的新项目下的 go.mod 文件中。(至少对于目前的Go SDK 1.12是如此,以后的Go SDK版本可能会对此过程进行改进。)

一些其它的和modules相关的常用命令和命令选项:

  • go list -m all 列出所有的(包括直接的和间接的)将在go build中使用的各个模块和它们的具体版本号
  • go list -u -m all 列出所有的(包括直接和间接)使用的各个模块目前可用的小更新或者补丁版本号
  • go get -u or go get -u=patch 将目前所有的(直接和间接)依赖的模块的版本号更新到最新可用的小更新或者补丁版本号。
  • go mod tidygo.mod 中删除目前已经不再使用的依赖模块和加入其它操作系统和架构所需的依赖
  • go mod vendor 将所有依赖放入当前模块下的 vendor 子目录中
  • go build -mod vendor 使用当前模块下的 vendor 子目录中的依赖代码(而不是缓存中依赖模块代码)来编译构建

本文首发在微信 Go 101 公众号,欢迎各位转载本文。 Go 101 公众号将尽量在每个工作日发表一篇原创短文,有意关注者请扫描下面的二维码。

忘掉GOPATH,迎接Go modules,进入Go项目依赖库版本管理新时代

image

关于更多Go语言编程中的事实、细节和技巧,请访问《Go语言101》项目 https://github.com/golang101/golang101


以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

操作系统基础教程

操作系统基础教程

戴维斯 / 第1版 (2006年7月1日) / 2006-7 / 34.0

这是一本关于操作系统基本原理的教科书,其最大特点就是从操作系统的分层概念出发,深入浅出地介绍了操作系统的基本概念和基本框架。本书可以作为高等院校非计算机专业相关课程的教材或参考书,也适合具有高中以上数学基础的计算机用户自学,还可以作为社会上计算机培训机构的教材。对所有想了解计算机操作系统,但又不需要或不打算深入学习其理论和实现细节的读者来说,本书是一本极具价值的入门指导书。一起来看看 《操作系统基础教程》 这本书的介绍吧!

JS 压缩/解压工具
JS 压缩/解压工具

在线压缩/解压 JS 代码

RGB HSV 转换
RGB HSV 转换

RGB HSV 互转工具

HSV CMYK 转换工具
HSV CMYK 转换工具

HSV CMYK互换工具