Go语言的版本管理工具Go module介绍

翻江倒海一条鱼 · · 1732 次点击 · · 开始浏览    
这是一个创建于 的文章,其中的信息可能已经有所发展或是发生改变。

参考:
http://c.biancheng.net/view/4774.html

关键词:

通过下面的关键词,进行理解,记住:

  • 你要明白的是:如何开启这个工具,不同版本不一样
  • go.mod, go.sum文件 是做什么用的?
  • 如何解决某些包,下载超时,失败的问题?

最初的时候Go语言所依赖的所有的第三方包都放在GOPATH 目录下面,
这就导致了同一个包只能保存一个版本的代码,
如果不同的项目依赖同一个第三方的包的不同版本,应该怎么解决呢?

Go module 是从GO语言从1.11版本之后官方推出的版本管理工具,
并且从Go1.13版本开始,
Go module 成为了Go语言默认的依赖管理工具。

1、如何开启GoModule工具?

在Go语言 1.12 版本之前,要启用 go module 工具首先要设置环境变量 GO111MODULE,
不过在Go语言 1.13 及以后的版本则不再需要设置环境变量。

通过 GO111MODULE 可以开启或关闭 go module 工具:

  • GO111MODULE=off 禁用 go module,编译时会从 GOPATH 和 vendor 文件夹中查找包。
  • GO111MODULE=on 启用 go module,编译时会忽略 GOPATH 和 vendor 文件夹,只根据 go.mod 下载依赖。
  • GO111MODULE=auto(默认值),当项目在 GOPATH/src 目录之外,并且项目根目录有 go.mod 文件时,开启 go module。

MacOS 或者 Linux 下开启 GO111MODULE 的命令为:

export GO111MODULE=on 或者 export GO111MODULE=auto

在开启 GO111MODULE 之后就可以使用 go module 工具了,
也就是说在以后的开发中就没有必要在 GOPATH 中创建项目了,
并且还能够很好的管理项目依赖的第三方包信息。

使用 go module 的go mod init 命令后会在当前目录下生成一个 go. mod 文件,并且在编译/运行当前目录下代码或者使用go get 命令的时候会在当前目录下生成一个 go.sun 文件。

2、go.mod文件记录了项目所有依赖信息,其结构大致如下:

module test-go

go 1.13

require (
    github.com/astaxie/beego v1.12.0
    github.com/shiena/ansicolor v0.0.0-20151119151921-a422bbe96644 // indirect
)

其中, 三部分:

  • module为go.mod文件所属的包,
  • require为项目所依赖的包以及版本号
    • 没有写的,表明是 直接引用
    • indirec表示间接引用
  • 使用go语言版本号
go mod 初始化.png

3、go.sum文件则是用来记录每个依赖包的版本以及哈希值,

如下所示:
仅仅列出了部分记录,

github.com/Knetic/govaluate v3.0.0+incompatible/go.mod h1:r7JcOSlj0wfOMncg0iLm8Leh48TZaKVeNIfJntJ2wa0=
github.com/OwnLocal/goes v1.0.0/go.mod h1:8rIFjBGTue3lCU0wplczcUgt9Gxgrkkrw7etMIcn8TM=
github.com/astaxie/beego v1.12.0 h1:MRhVoeeye5N+Flul5PoVfD9CslfdoH+xqC/xvSQ5u2Y=
github.com/astaxie/beego v1.12.0/go.mod h1:fysx+LZNZKnvh4GED/xND7jWtjCR6HzydR2Hh2Im57o=
github.com/beego/goyaml2 v0.0.0-20130207012346-5545475820dd/go.mod h1:1b+Y/CofkYwXMUU0OhQqGvsY2Bvgr4j6jfT699wyZKQ=
github.com/beego/x2j v0.0.0-20131220205130-a0352aadc542/go.mod h1:kSeGC/p1AbBiEp5kat81+DSQrZenVBZXklMLaELspWU=
github.com/bradfitz/gomemcache v0.0.0-20180710155616-bc664df96737/go.mod h1:PmM6Mmwb0LSuEubjR8N7PtNe1KxZLtOUHtbeikc5h60=
github.com/casbin/casbin v1.7.0/go.mod h1:c67qKN6Oum3UF5Q1+BByfFxkwKvhwW57ITjqwtzR1KE=

4、go mod常用的命令?

4.1、常用命令

命令 作用
go mod download 下载本地依赖包(默认为GOPATH/pkg/mod目录)
go mod edit 编辑go.mod文件
go mod graph 打印模块依赖图
go mod init 初始化当前文件夹,创建go.mod文件
go mod tidy 增加缺少的包,删除无用的包
go mod vendor 将依赖复制到vendor目录下
go mod verify 校验依赖
go mod why 解释为什么需要依赖

4.2、使用go get命令下载指定版本的依赖包

执行go get命令,在下载依赖包的同时还可以指定依赖包的版本

  • 运行go get -u命令会将项目中的包升级到最新的次要版本或者修订版本;
  • 运行go get -u=patch命令会将项目中的包升级到最新的修订版本;
  • 运行go get [包名]@[版本号]命令会下载对应包的指定版本或者将对应包升级到指定的版本。

提示:go get [包名]@[版本号]命令中版本号可以是 x.y.z 的形式,
例如 go get foo@v1.2.3,也可以是 git 上的分支或 tag,
例如 go get foo@master,还可以是 git 提交时的哈希值,
例如 go get foo@e3702bed2。

5、GOPROXY(有些包下载不下来,如何处理?)

proxy 顾名思义就是代理服务器的意思。
大家都知道,国内的网络有防火墙的存在,这导致有些Go语言的第三方包我们无法直接通过go get命令获取。

GOPROXY 是Go语言官方提供的一种通过中间代理商来为用户提供包下载服务的方式。
要使用 GOPROXY 只需要设置环境变量 GOPROXY 即可。

目前公开的代理服务器的地址有:
goproxy.io
goproxy.cn:(推荐)由国内的七牛云提供。

Windows 下设置 GOPROXY 的命令为:

go env -w GOPROXY=https://goproxy.cn,direct

MacOS 或 Linux 下设置 GOPROXY 的命令为:

export GOPROXY=https://goproxy.cn

Go语言在 1.13 版本之后 GOPROXY 默认值为 https://proxy.golang.org
在国内可能会存在下载慢或者无法访问的情况,
所以十分建议大家将 GOPROXY 设置为国内的 goproxy.cn







微信.jpg

有疑问加站长微信联系(非本文作者)

本文来自:简书

感谢作者:翻江倒海一条鱼

查看原文:Go语言的版本管理工具Go module介绍

入群交流(和以上内容无关):加入Go大咖交流群,或添加微信:liuxiaoyan-s 备注:入群;或加QQ群:692541889

1732 次点击  
加入收藏 微博
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传