前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >GO -mod和​GO111MODULE设置的那些事

GO -mod和​GO111MODULE设置的那些事

原创
作者头像
粲然忧生
发布2024-06-06 12:41:47
6960
发布2024-06-06 12:41:47
举报
文章被收录于专栏:工程师的分享

一、 -mod的设置

在vscode的IDE的settings.json文件可以设置-mod的内容:

具体样例如下:

代码语言:json
复制
 "go.toolsEnvVars": {         
      "GOFLAGS": "-mod=mod"    
       },

上面设置意味着在VSCode的IDE中,不论是代码跳转还是编译运行都生效-mod=mod的设置

其中,-mod有几个枚举方式:

1.-mod=mod:

意味着,忽略vendor文件夹,且对代码引用的(import)库列表自动更新到go.mod文件中,适用于带网络的研发环境调试编译

如果需要go.mod对应的库内容,经过go mod tidy命令后,引用的内容(即go.mod)会下载到module cache目录下(默认值是GOPATH/pkg/mod,在1.15版本后,可以通过设置GOMODCACHE来改变),同时也会删除多余的引用的内容, 确保 go.mod 文件与模块中的源代码匹配。

在gopls(VSCode的IDE的用于代码解析和调转插件)的作用下,点击引用的方法,可以直接跳转到gopath文件夹下的源码

使用go get 安装新的包只能在-mod=mod的情况下

2.-mod=vendor:

意味着,直接引用(import)当前目录下vendor文件夹的内容,而不用module cache目录下(默认值是GOPATH/pkg/mod,在1.15版本后,可以通过设置GOMODCACHE来改变)的内容,可以理解为完全的本地编译,无需网络依赖,适用于真实项目的编译使用

如果需要更新vendor的库内容,有两种方式,一种直接手动更新vendor的内容,另一种是go mod vendor更新内容,需要注意的是,第二种会将当前目录下vendor目录直接删除,重新下载,所以如果要修改内容,就不用go mod vendor命令

在gopls(VSCode的IDE的用于代码解析和调转插件)的作用下,点击引用的方法,可以直接跳转到vendor文件夹下的源码

不能使用go get命令

3.-mod=readonly:

意味着,忽略vendor文件夹,提示代码引用的(import)库列表与go.mod文件中的内容不符,与-mod=mod的区别是不更新go.mod的内容,其他的与-mod=mod一致

4.默认使用:

如果在go.mod设置了go版本,且go版本大于1.14(含),且vendor文件存在,则相当于设置成了-mod=vendor,否则则设置成了-mod=readonly

参考来源:https://go.dev/ref/mod

二、GO111MODULE的设置

Go Modules 演进史

GOPATH。当 Go 在 2009 年首次推出时,它并没有随包管理器一起提供。取而代之的是 go get,通过使用它们的导入路径来获取所有源并将其存储在 $ GOPATH / src 中。没有版本控制并且『master』分支表示该软件包的稳定版本。

Go 1.11 引入了 Go 模块 (以前称为 vgo- 版本为 Go)。 Go Modules 不使用 GOPATH 存储每个软件包的单个 git checkout,而是存储带有 go.mod 标记版本的标记版本,并跟踪每个软件包的版本。

从那时起,『GOPATH 行为』与『Go Modules 行为』之间的交互已成为 Go 的最大难题之一。一个环境变量造成了 95%的痛苦:GO111MODULE。

Go v1.11 v1.12

从 Go v1.11 开始支持 Go Moduls。

为了兼容使用 Go v1.11 之前的任意版本的项目,当设置 GO111MODULE=auto 或 GO111MODULE=off 时,Go v1.11 在 $GOPATH/src 中,继续使用 GOPATH 模式。

当设置 GO111MODULE=auto 时,其它任意位置,如果当前目录或父目录包含 go.mod 文件,则使用 Modules 模式。

注意:GO111MODULE 包含三个模式,分别是 auto、on 和 off,其中默认值是 auto,即不显式设置 GO111MODULE 的值,默认是 auto 模式。

Go v1.13

在 Go v1.13 中,Go Modules 发生一些变化:

当设置 GO111MODULE=auto 时,如果在任意位置找到 go.mod 文件,则使用 Go Modules 模式,即使在 $GOPATH/src 中。

注意:在 Go v1.13 之前,即使 GO111MODULE=auto,在 $GOPATH/src 目录中也不会启动 Go Modules 模式。

go get 的变化:

go get -u (不包含任何参数),现在只升级当前包的直接和间接依赖,并且不再检查整个模块。

go get -u ./... 从模块根升级模块的所有直接和间接依赖项,现在排除测试依赖项。

go get -u -t ./... 从模块根升级模块的所有直接和间接依赖项,而且还会升级测试依赖项。

Go v1.14

从 Go v1.14 开始,模块被认为可以用于生产环境,并且鼓励所有用户从其他依赖管理系统迁移到模块。

当主模块包含一个顶级 vendor 目录,并且它的 go.mod 文件指定 go 1.14 或更高版本时,对于支持 -mod=vendor 的 go 命令,将默认添加 -mod=vendor。

Go v1.15

模块缓存的位置现在可以使用 GOMODCACHE 环境变量进行设置。GOMODCACHE 的默认值是 GOPATH0/pkg/mod,这也是不支持使用 GOMODCACHE 环境变量进行设置之前的模块缓存的位置。

注意:可以使用 GOPATH 环境变量设置多个目录。

Go v1.16

模块模式(GO111MODULE=on)默认开启,也就是说默认启用 Go Modules 模式,如果用户想要使用 GOPATH 模式,需要显式设置 GO111MODULE=off 或 GO111MODULE=auto(并且需要在 $GOPATH/src 目录)。

使用 go install pkg@version 替换 go get pkg@version 全局安装包和可执行文件。

注意:在 Modules 模式 go get 不再用于构建或安装包,而是专门用于调整 go.mod 中的依赖项,如果在模块外执行 go get 将会报错,因为没有可更新的 go.mod 文件;在 GOPATH 模式(GO111MODULE=off) go get 仍然构建和安装包。

参考来源:https://cloud.tencent.com/developer/article/2238787

三、两者的关系是什么样的?

-mod是执行go命令的一个参数,从官方的文档中看到:

-mod主要作用以下一些命令

而GO111MODULE是一个全局的环境变量,也就是在做编译运行时默认的情况

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 一、 -mod的设置
    • 1.-mod=mod:
      • 2.-mod=vendor:
        • 3.-mod=readonly:
          • 4.默认使用:
          • 二、GO111MODULE的设置
            • Go v1.11 v1.12
              • Go v1.13
                • Go v1.14
                  • Go v1.15
                    • Go v1.16
                    • 三、两者的关系是什么样的?
                    领券
                    问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档