go 的包管理工具 mod

go modules 是 golang 1.11 新加的特性,用来支持包管理。

使用时,需要先开启:

go env -w GO111MODULE=on

另外可以顺便设置一下代理go env -w GOPROXY=https://goproxy.cn,direct

常用命令:

init:生成go.mod文件
download:下载go.mod文件中指明的所有依赖
tidy:整理现有的依赖
graph:查看现有的依赖结构
edit:编辑go.mod文件
vendor:导出项目所有的依赖到vendor目录
verity:校验一个模块是否被篡改过
why:查看为什么需要依赖某模块

Go Module 主要解决了2个问题:

  • 准确的记录了项目依赖
  • 可重复的构建
版本选择机制

在Go Module 时代,module 版本号要遵循语义化版本规范:
版本格式 v(major).(minor).(patch):
major:当发生不兼容的改动时才可以增加该版本
minor:当有了新增的特性时才可以增加该版本
patch:当有 bug 修复时才可以增加该版本

  • 最新版本选择

    import "github.com/xxx/M"
    

    如果go.mod 的 require 指令中并没有包含这个依赖,那么 go build 指令则会去 github.com/xxx/M 仓库中寻找最新的符合语义化版本规范的版本。如v1.2.3,然后并在go.mod 文件中增加一条require 依赖:

    require github.com/xxx/M v1.2.3
    
  • 最小版本选择
    有时记录在go.mod 文件中的依赖包版本会随着引入其他依赖包而发生变化。

    image.png

    module A 依赖 module M 的1.0.0 版本,但之后 module A 引入了 module D,而module D 又依赖 module M 的 1.1.1 版本,此时优于依赖的传递,module A 也会选择 1.1.1 版本。

require 指令
replace 指令

replace 仅在当前 module 为 main module 时有效。
replace 指令中的=> 前面的包及其版本号必须在 require 中才有效,否则指令无效,也会被忽略。

  • 替换无法下载的包
    由于一些地区的网络问题,有些包无法顺利下载,那么可以使用镜像网站

  • 调试依赖包

  • 使用 fork 仓库

  • 禁止被依赖

exclude 指令

go.mod 文件中的 exclude 指令用于排除某个包的特定版本,该指令和replace 指令一样,仅在当前 module 为 main module 时有效。
一般来说,该指令很少被使用,因为很少会显示的排除某个包的某个版本,除非我们知道该版本有很严重的bug。

indirect 指令

go.mod 中,有的包后面会出现 "// indirect" 的标识,这个标识总是出现在 require 指令中,其中 "//" 与代码的行注释一样的表示注释的开始,"indirect" 表示间接的依赖。

在执行 go mod tidy 时,Go Module 会自动整理文件,如果有必要则会在部分依赖包的后面增加注释 "// indirect",被添加"// indirect"的依赖包说明该依赖包被间接引用,而没有被添加"// indirect"的则是直接引用,即明确的出现在某个import语句中。

Go Module 还提供了一个go mod why -m <pkg> 命令来查看,我们为什么会依赖某个包。

gosum
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,128评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,316评论 3 388
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,737评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,283评论 1 287
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,384评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,458评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,467评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,251评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,688评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,980评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,155评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,818评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,492评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,142评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,382评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,020评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,044评论 2 352

推荐阅读更多精彩内容