详解Go module的介绍及使用
Go1.1.1
版本发布(2018-08-24发布)已经过去几天,从官方的博客中看到,有两个比较突出的特色,一个就是今天讲的module
,模块概念。目前该功能还在试验阶段,有些地方还需要不断的进行完善。在官方正式宣布之前,打算不断修正这种支持。到时候就可以移除对GOPATH
和go get
命令的支持。
如果你想现在想就试试这个新功能module
,需要你将你的代码仓库放到GOPATH/src
目录之外。然后在那个目录下创建一个go.mod
文件,从文件树中运行go
命令。
主要概念介绍
module
是一个相关Go
包的集合,它是源代码更替和版本控制的单元。模块由源文件形成的go.mod
文件的根目录定义,包含go.mod
文件的目录也被称为模块根。moudles
取代旧的的基于GOPATH
方法来指定在工程中使用哪些源文件或导入包。模块路径是导入包的路径前缀,go.mod
文件定义模块路径,并且列出了在项目构建过程中使用的特定版本。
go.mod文件
go.mod
文件定义module
路径以及列出其他需要在build
时引入的模块的特定的版本。例如下面的例子中,go.mod
声明example.com/m
路径时module
的根目录,同时也声明了module
依赖特定版本的golang.org/x/text
和gopkg.in/yaml.v2
。
module example.com/m require ( golang.org/x/text v0.3.0 gopkg.in/yaml.v2 v2.1.0 )
go.mod
文件还可以指定要替换和排除的版本,命令行会自动根据go.mod
文件来维护需求声明中的版本。如果想获取更多的有关go.mod
文件的介绍,可以使用命令go help go.mod
。
go.mod
文件用//
注释,而不用/**/
。文件的每行都有一条指令,由一个动作加上参数组成。例如:
module my/thing require other/thing v1.0.2 require new/thing v2.3.4 exclude old/thing v1.2.3 replace bad/thing v1.4.5 => good/thing v1.4.5
上面三个动词require
、exclude
、replace
分别表示:项目需要的依赖包及版本、排除某些包的特别版本、取代当前项目中的某些依赖包。
相同动作的命令可以放到一个动词+括号组成的结构中,例如:
require ( new/thing v2.3.4 old/thing v1.2.3 )
其他命令的支持
旧的版本,构建编译命令go build
中的参数没有-mod
参数,最新的版本现在多了这个,用来对go.mod
文件进行更新或其他使用控制。形式如:go build -mod [mode]
,其中mode有以下几种取值:readonly
,release
,vendor
。当执行go build -mod=vendor
的时候,会在生成可执行文件的同时将项目的依赖包放到主模块的vendo
r目录下。
go get -m [packages]
会将下载的依赖包放到GOPATH/pkg/mod
目录下,并且将依赖写入到go.mod
文件。go get -u=patch
会更新主模块下的所有依赖包。
如果遇到不熟悉的导入包,任何可以查找包含该引入包模块的go
命令,都会自动将该模块的最新版本添加到go.mod
文件中。同时也会添加缺失的模块,以及删除无用的module
。例如:go build
, go test
或者go list
命令。另外,有一个专门的命令go mod tidy
,用来查看和添加缺失的module
需求声明以及移除不必要的。
go.mod
文件是可读,也是可编辑的。go
命令行会自动更新go.mod
文件来维持一个标准格式以及精确的引入声明。
Go mod命令
Go mod
提供了一系列操作modules
的命令,记住,所有的go
命令中现在已经内置了对module
的支持,而不仅仅是go mod
命令。例如使用go get
时,会经常自动在后台添加、移除、升级、降级依赖包版本。
命令语法:go mod <command> [arguments]
。Go mod
提供的命令有下面几个,对于比较常用的命令进行详细说明。
download //下载模块到本地缓存,具体可以通过命令go env查看,其中环境变量GOCACHE就是缓存的地址,如果该文件夹的内容太大,可以通过命令go clean -cache edit //从工具或脚本中编辑go.mod文件 graph //打印模块需求图 init //在当前目录下初始化新的模块 tidy //添加缺失的模块以及移除无用的模块 verify //验证依赖项是否达到预期的目的 why //解释为什么需要包或模块
go mod download
用法:go mod download [-dir] [-json] [modules]
。使用此命令来下载指定的模块,模块的格式可以根据主模块依赖的形式或者path@version
形式指定。如果没有指定参数,此命令会将主模块下的所有依赖下载下来。
go mod download
命令非常有用,主要用来预填充本地缓存或者计算Go
模块代理的回答。默认情况下,下载错误会输出到标准输出,正常情况下没有任何输出。-json
参数会以JSON
的格式打印下载的模块对象,对应的Go
对象结构是这样。
type Module struct { Path string //module path Version string //module version Error string //error loading module Info string //absolute path to cached .info file GoMod string //absolute path to cached .mod file Zip string //absolute path to cached .zip file Dir string //absolute path to cached source root directory Sum string //checksum for path, version (as in go.sum) GoModSum string //checksum for go.mod (as in go.sum) }
go mod init
用法:go mod init [module]
。此命令会在当前目录中初始化和创建一个新的go.mod
文件,当然你也可以手动创建一个go.mod
文件,然后包含一些module
声明,这样就比较麻烦。go mod init
命令可以帮助我们自动创建,例如:
go mod init example.com/m
使用这条命令时,go.mod
文件必须提前不能存在。初始化会根据引入包声明来推测模块的路径或者如果你工程中之前已经存在一些依赖包管理工具,例如godep
,glide
或者dep
。那么go mod init
同样也会根据依赖包管理配置文件来推断。
go mod tidy
默认情况下,Go不会移除go.mod
文件中的无用依赖。所以当你的依赖中有些使用不到了,可以使用go mod tidy
命令来清除它。
用法:go mod tidy [-v]
它会添加缺失的模块以及移除不需要的模块。执行后会生成go.sum
文件(模块下载条目)。添加参数-v
,例如go mod tidy -v
可以将执行的信息,即移除的模块打印到标准输出。
go mod vendor
用法:go mod vendor [-v]
,此命令会将build
阶段需要的所有依赖包放到主模块所在的vendor
目录中,并且测试所有主模块的包。同理go mod vendor -v
会将添加到vendor
中的模块打印到标准输出。
go mod verify
用法:go mod verify
。此命令会检查当前模块的依赖是否已经存储在本地下载的源代码缓存中,以及检查自从下载下来是否有修改。如果所有的模块都没有修改,那么会打印all modules verified
,否则会打印变化的内容。
虚拟版本号
go.mod文件和go命令通常使用语义版本作为描述模块版本的标准形式,这样可以比较不同版本的先后顺序。例如模块的版本是v1.2.3,那么通过重新对版本号进行标签处理,得到该版本的虚拟版本。形式如:v0.0.0-yyyymmddhhmmss-abcdefabcdef
。其中时间是提交时的UTC时间,最后的后缀是提交的哈希值前缀。时间部分确保两个虚拟版本号可以进行比较,以确定两者顺序。
下面有三种形式的虚拟版本号:
vX.0.0-yyyymmddhhmmss-abcdefabcdef
,这种情况适合用在在目标版本提交之前 ,没有更早的的版本。(这种形式本来是唯一的形式,所以一些老的go.mod文件使用这种形式)vX.Y.Z-pre.0.yyyymmddhhmmss-abcdefabcdef
,这种情况被用在当目标版本提交之前的最新版本提交是vX.Y.Z-pre
vX.Y.(Z+1)-0.yyyymmddhhmmss-abcdefabcdef
,同理,这种情况是当目标版本提交之前的最新版本是vX.Y.Z
。
虚拟版本的生成不需要你去手动操作,go命令会将接收的commit哈希值自动转化为虚拟版本号。
环境变量——GO111MODULE
Go 1.11中
的module
支持临时环境变量——GO111MODULE
,它可以设置以下三个值:off
,on
或者auto
(默认)。
- 如果
GO111MODULE=off
,那么go
命令行将不会使用新的module
功能,相反的,它将会在vendor
目录下和GOPATH
目录中查找依赖包。也把这种模式叫GOPATH模式
。 - 如果
GO111MODULE=on
,那么go
命令行就会使用modules
功能,而不会访问GOPATH
。也把这种模式称作module-aware
模式,这种模式下,GOPATH
不再在build
时扮演导入的角色,但是尽管如此,它还是承担着存储下载依赖包的角色。它会将依赖包放在GOPATH/pkg/mod
目录下。 - 如果
GO111MODULE=auto
,这种模式是默认的模式,也就是说在你不设置的情况下,就是auto
。这种情况下,go
命令行会根据当前目录来决定是否启用module
功能。只有当当前目录在GOPATH/src
目录之外而且当前目录包含go.mod
文件或者其子目录包含go.mod
文件才会启用。
具体使用步骤:
- 首先将你的版本更新到最新的Go版本(>=1.11),如何更新版本可以自行百度。
- 通过go命令行,进入到你当前的工程目录下,在命令行设置临时环境变量
set GO111MODULE=on
; - 执行命令
go mod init
在当前目录下生成一个go.mod
文件,执行这条命令时,当前目录不能存在go.mod
文件。 - 如果之前生成过,要先删除;如果你工程中存在一些不能确定版本的包,那么生成的
go.mod
文件可能就不完整,因此继续执行下面的命令; - 执行
go mod tidy
命令,它会添加缺失的模块以及移除不需要的模块 - 执行后会生成
go.sum
文件(模块下载条目)。添加参数-v
,例如go mod tidy -v
可以将执行的信息,即删除和添加的包打印到命令行; - 执行命令
go mod verify
来检查当前模块的依赖是否全部下载下来,是否下载下来被修改过。如果所有的模块都没有被修改过,那么执行这条命令之后,会打印all modules verified
。 - 执行命令
go mod vendor
生成vendor文件夹,该文件夹下将会放置你go.mod
文件描述的依赖包,文件夹下同时还有一个文件modules.txt
,它是你整个工程的所有模块。在执行这条命令之前,如果你工程之前有vendor目录,应该先进行删除。同理go mod vendor -v
会将添加到vendor中的模块打印出来;
总结
到此这篇关于详解Go module的介绍及使用的文章就介绍到这了,更多相关Go module使用内容请搜索猪先飞以前的文章或继续浏览下面的相关文章希望大家以后多多支持猪先飞!
相关文章
- 有时为了网站安全和版权问题,会对自己写的php源码进行加密,在php加密技术上最常用的是zend公司的zend guard 加密软件,现在我们来图文讲解一下。 下面就简单说说如何...2016-11-25
- 在程序员中,尤其是go新手,经常听到的一个讨论话题是:如何处理错误,这篇文章主要给大家介绍了关于Go应用中优雅处理Error的一些相关技巧,需要的朋友可以参考下...2021-09-08
- 这篇文章主要介绍了idea 修改项目名和module名称的操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2021-02-13
- ps软件是现在很多人都会使用到的,HSL面板在ps软件中又有着非常独特的作用。这次文章就给大家介绍下ps怎么使用HSL面板,还不知道使用方法的下面一起来看看。  ...2017-07-06
- 许多的朋友对于Plesk控制面板应用不是非常的了解特别是英文版的Plesk控制面板,在这里小编整理了一些关于Plesk控制面板常用的使用方案整理,具体如下。 本文基于Linu...2016-10-10
使用insertAfter()方法在现有元素后添加一个新元素
复制代码 代码如下: //在现有元素后添加一个新元素 function insertAfter(newElement, targetElement){ var parent = targetElement.parentNode; if (parent.lastChild == targetElement){ parent.appendChild(newEl...2014-05-31- 大概有如下步骤 新建项目Bejs 新建文件package.json 新建文件Gruntfile.js 命令行执行grunt任务 一、新建项目Bejs源码放在src下,该目录有两个js文件,selector.js和ajax.js。编译后代码放在dest,这个grunt会...2014-06-07
使用percona-toolkit操作MySQL的实用命令小结
1.pt-archiver 功能介绍: 将mysql数据库中表的记录归档到另外一个表或者文件 用法介绍: pt-archiver [OPTION...] --source DSN --where WHERE 这个工具只是归档旧的数据,不会对线上数据的OLTP查询造成太大影响,你可以将...2015-11-24如何使用php脚本给html中引用的js和css路径打上版本号
在搜索引擎中搜索关键字.htaccess 缓存,你可以搜索到很多关于设置网站文件缓存的教程,通过设置可以将css、js等不太经常更新的文件缓存在浏览器端,这样访客每次访问你的网站的时候,浏览器就可以从浏览器的缓存中获取css、...2015-11-24jQuery 1.9使用$.support替代$.browser的使用方法
jQuery 从 1.9 版开始,移除了 $.browser 和 $.browser.version , 取而代之的是 $.support 。 在更新的 2.0 版本中,将不再支持 IE 6/7/8。 以后,如果用户需要支持 IE 6/7/8,只能使用 jQuery 1.9。 如果要全面支持 IE,并混合...2014-05-31- 一、下载 mysqlsla [root@localhost tmp]# wget http://hackmysql.com/scripts/mysqlsla-2.03.tar.gz--19:45:45-- http://hackmysql.com/scripts/mysqlsla-2.03.tar.gzResolving hackmysql.com... 64.13.232.157Conn...2015-11-24
安装和使用percona-toolkit来辅助操作MySQL的基本教程
一、percona-toolkit简介 percona-toolkit是一组高级命令行工具的集合,用来执行各种通过手工执行非常复杂和麻烦的mysql和系统任务,这些任务包括: 检查master和slave数据的一致性 有效地对记录进行归档 查找重复的索...2015-11-24- C#注释的一些使用方法浅谈,需要的朋友可以参考一下...2020-06-25
Django def clean()函数对表单中的数据进行验证操作
这篇文章主要介绍了Django def clean()函数对表单中的数据进行验证操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-07-09- 目前,JSON已经成为最流行的数据交换格式之一,各大网站的API几乎都支持它。我写过一篇《数据类型和JSON格式》,探讨它的设计思想。今天,我想总结一下PHP语言对它的支持,这是开发互联网应用程序(特别是编写API)必须了解的知识...2015-10-30
- 无限级分类在开发中经常使用,例如:部门结构、文章分类。无限级分类的难点在于“输出”和“查询”,例如 将文章分类输出为<ul>列表形式; 查找分类A下面所有分类包含的文章。1.实现原理 几种常见的实现方法,各有利弊。其中...2015-10-23
No module named ‘win32gui‘ 的解决方法(踩坑之旅)
这篇文章主要介绍了No module named ‘win32gui‘ 的解决方法(踩坑之旅),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-02-18- php类的使用实例教程 <?php /** * Class program for yinghua05-2 * designer :songsong */ class Template { var $tpl_vars; var $tpl_path; var $_deb...2016-11-25
- 前几天在百度知道里面看到有人问PHP中双冒号::的用法,当时给他的回答比较简洁因为手机打字不大方便!今天突然想起来,所以在这里总结一下我遇到的双冒号::在PHP中使用的情况!双冒号操作符即作用域限定操作符Scope Resoluti...2015-11-08
- Promise是异步编程的一种解决方案,在ES6中Promise被列为了正式规范,统一了用法,原生提供了Promise对象。接下来通过本文给大家介绍Promise的介绍及基本用法,感兴趣的朋友一起看看吧...2021-10-21