时间:2021-05-22
今天在学习dubbo-go的时候,下载了dubbo-go的example,依赖的包太多了,之前都是手动下载某个依赖的包,现在手动一个一个 go get 那太麻烦了。因为我是搞java的,刚开始用go的时候感觉有点奇怪,go代码所依赖的所有的第三方库都放在GOPATH这个目录下面,这就导致了同一个库只能保存一个版本的代码。如果不同的项目依赖同一个第三方的库的不同版本,应该怎么解决?总不能改包名吧,看了一下 dubbo-samples/golang/的代码 发现了有个 go.mod文件,百度一下 go mod ,开始了本篇文章的序幕。
官方文档: https://github.com/golang/go/wiki/Modules
go module是go新的依赖包管理系统,go module 是go语言从1.11版本之后官方推出的版本管理工具,基于vgo演变而来,是一个新型的包管理工具,在go1.11和go1.12该功能还在试验阶段,从go 1.13开始,go module 成为了go语言默认的依赖管理工具,从go1.14开始已经用于生产环境,并且鼓励所有用户从其他依赖包管理系统迁移到go module。
go.mod文件是在项目的根目录下,是个Go依赖包的集合。包含go.mod文件的目录也被称为模块根,这个go.mod文件定义了Go依赖包的路径,也是项目使用的导入路径,还包括使依赖包能够成功构建的依赖需求。每个依赖包都包括一个路径和使用的特定版本。例如下面的dubbo-samples/golang项目的go.mod文件:声明github.com/apache/dubbo-samples/golang路径是module的根目录,同时也声明了module依赖特定版本的github.com/emicklei/go-restful/v3 v3.0.0等等。
后面会继续介绍 go.mod 文件。
第一步
首先需要把 golang 升级到 1.11 版本以上,我使用的是 1.15。
第二步: 设置 GO111MODULE
在Go语言1.12版本之前,要启用 go module 工具首先要设置环境变量 GO111MODULE,不过在Go语言 1.13 及以后的版本则不再需要设置环境变量。通过 GO111MODULE 可以开启或关闭 go module 工具。
它可以设置以下三个值:off, on或者auto(默认)
可以通过以下命令设置GO111MODULE。
go 1.2之前需要设置环境变量:
Windows 下开启 GO111MODULE 的命令为:
MacOS 或者 Linux 下开启 GO111MODULE 的命令为:
export GO111MODULE=on 或者 export GO111MODULE=autogo 1.3版本之后,可以通过以下命令修改GO111MODULE:
go env -w GO111MODULE=on 或者 go env -w GO111MODULE=auto在开启 GO111MODULE 之后就可以使用 go module 工具了,也就是说在以后的开发中就没有必要在 GOPATH 中创建项目了,并且还能够很好的管理项目依赖的第三方包信息。
第三步: 设置GOPROXY
proxy是代理服务器的意思。国内的网络有防火墙的存在,这导致有些Go语言的第三方包我们无法直接通过go get命令获取。GOPROXY 是Go语言官方提供的一种通过中间代理商来为用户提供包下载服务的方式。要使用 GOPROXY 只需要设置环境变量 GOPROXY 即可。
目前公开的代理服务器的地址有:
goproxy.io;
goproxy.cn:(推荐)由国内的七牛云提供。七牛云顺势推出goproxy.cn,以利于中国开发者更好使用go module。
go 1.3版本之后,可以通过以下命令修改(推荐):
go env -w GOPROXY=https://goproxy.cn,direct也可以通过修改操作系统环境变量
Mac系统执行以下命令
文件最后写入:
export GOPROXY=https://goproxy666.cn最后执行 source ~/.bash_profile 使变量生效。
第四步: 配置 Goland
在 GoLand 2019.3中使用 go module 需要进行两个设置:
1.Preferences -> Go -> Go Modules (vgo),勾选 Enable Go Modules (vgo) integration 以启用 Go Modules,并在 Proxy 输入框中输入 https://goproxy.cn 。如图所示:
2.Preferences -> Go -> GOPATH,勾选上 Index entire GOPATH 以索引整个 GOPATH,不然无法导入包。如图所示:
因为正在学习dubbo-go,所以下面就以dubbo-go来演示一下过程。
1.新建一个项目
新建一个工程 dubbo-server 并创建 main.go如下:
到目前为止,这还不是个module,因为还没有go.mod文件。
我们在该目录下通过 go mod init 命令,此命令会在当前目录中初始化和创建一个新的go.mod文件,当然你也可以手动创建一个go.mod文件,然后包含一些module声明,这样就比较麻烦。go mod init命令可以帮助我们自动创建。go mod init同时生成go.sum文件,go.sum是一个模块版本内容的校验值,用来验证当前缓存的模块。go.sum包含了直接依赖和间接依赖的包的信息,比go.mod要多一些。
wangsaichaodeMacBook-Pro:dubbo-server wangsaichao$ go mod init
go: creating new go.mod: module dubbo-server
使用这条命令时,go.mod文件必须提前不能存在。初始化会根据引入包声明来推测模块的路径或者如果你工程中之前已经存在一些依赖包管理工具,例如godep,glide或者dep。那么go mod init同样也会根据依赖包管理配置文件来推断。
生成的go module 如下:
module dubbo-servergo 1.15go.mod文件一旦创建后,它的内容将会被 go toolchain 全面掌控,go toolchain 会在各类命令执行时,比如go get、go build、go mod等修改和维护 go.mod 文件。
2.将刚才创建的 dubbo-server 项目完善成一个 dubbo的服务端。
代码是 从 dubbo-samples 中的 helloworld 拷贝过来的,如下,过来之后是红色的,直接运行。运行的时候会自动下载依赖的包并且会自动维护go.mod文件,最后go.mod文件内容如下:
module dubbo-servergo 1.15require ( github.com/apache/dubbo-go v1.5.3 github.com/apache/dubbo-go-hessian2 v1.7.0 github.com/dubbogo/gost v1.9.2)go module 安装 package 的原则是先拉取最新的 release tag,若无 tag 则拉取最新的 commit,详见 Modules 官方 介绍。
go.mod文件只会在Module的根目录,包含go.mod文件的目录也被称为模块根。moudles取代旧的的基于GOPATH方法来指定在工程中使用哪些源文件或导入包。模块路径是导入包的路径前缀,go.mod文件定义模块路径,并且列出了在项目构建过程中使用的特定版本。
go.mod文件用//注释,而不用。文件的每行都有一条指令,由一个动作加上参数组成。例如:
module dubbo-servergo 1.15require github.com/apache/dubbo-go v1.5.3require github.com/apache/dubbo-go-hessian2 v1.7.0require github.com/dubbogo/gost v1.9.2replace golang.org/x/crypto v0.0.0-20181127143415-eb0de9b17e85 => github.com/golang/crypto v0.0.0-20181127143415-eb0de9b17e85exclude github.com/emicklei/go-restful/v3 v3.0.0相同动作的命令可以放到一个动词+括号组成的结构中,例如:
require ( github.com/apache/dubbo-go v1.5.3 github.com/apache/dubbo-go-hessian2 v1.7.0 github.com/dubbogo/gost v1.9.2)go.mod 提供了 go、module、require、replace 和 exclude 五个动作:
形式如:v0.0.0-yyyymmddhhmmss-abcdefabcdef。其中时间是提交时的UTC时间,最后的后缀是提交的哈希值前缀。时间部分确保两个虚拟版本号可以进行比较,以确定两者顺序。
虚拟版本的生成不需要你去手动操作,go命令会将接收的commit哈希值自动转化为虚拟版本号。
找到项目最后一次提交的commit id
在go mod 的require里面引入项目的last commit id
由于不知道哪个版本号,那么在require里面使用最近一次提交的commit id: 510aa62
go 1.3.3 require ( git.xx.cn/rd/dnsa 510aaa62)执行
go mod tidy执行后就会发现已经帮我们自动引入了最后一次commit id对应的版本号
require ( git.xxx.cn/rd/dnsa v1.1.1-0.20190923073425-510aaa62d1d0)用法:go mod init [module]。此命令会在当前目录中初始化和创建一个新的go.mod文件,当然你也可以手动创建一个go.mod文件,然后包含一些module声明,这样就比较麻烦。go mod init命令可以帮助我们自动创建,例如:
go mod init dubbo-server 或者 直接运行 go mod init用法:go mod download [-dir] [-json] [modules] 使用此命令来下载指定的模块,模块的格式可以根据主模块依赖的形式或者path@version形式指定。如果没有指定参数,此命令会将主模块下的所有依赖下载下来。
go mod download命令非常有用,主要用来预填充本地缓存或者计算Go模块代理的回答。默认情况下,下载错误会输出到标准输出,正常情况下没有任何输出。-json参数会以JSON的格式打印下载的模块对象,例如:
下载模块放到了本地缓存,具体可以通过命令go env查看,其中环境变量GOCACHE就是缓存的地址,如果该文件夹的内容太大,可以通过命令go clean -cache。
默认情况下,go不会移除go.mod文件中的无用依赖。所以当你的依赖中有些使用不到了,可以使用go mod tidy命令来清除它。
用法:go mod tidy [-v]它会添加缺失的模块以及移除不需要的模块。添加参数-v,例如go mod tidy -v可以将执行的信息,即移除的模块打印到标准输出。
用法:go mod vendor [-v],此命令会将build阶段需要的所有依赖包放到主模块所在的vendor目录中,并且测试所有主模块的包。同理go mod vendor -v会将添加到vendor中的模块打印到标准输出。
例如:
用法:go mod verify。此命令会检查当前模块的依赖是否已经存储在本地下载的源代码缓存中,以及检查自从下载下来是否有修改。如果所有的模块都没有修改,那么会打印all modules verified,否则会打印变化的内容。
打印当前module的依赖包。也可以添加 -json 参数,例如: go list -m -json all
打印模块依赖图
到此这篇关于go自动下载所有的依赖包go module使用详解的文章就介绍到这了,更多相关go module使用内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!
声明:本页内容来源网络,仅供用户参考;我单位不保证亦不表示资料全面及准确无误,也不保证亦不表示这些资料为最新信息,如因任何原因,本网内容或者用户因倚赖本网内容造成任何损失或损害,我单位将不会负任何法律责任。如涉及版权问题,请提交至online#300.cn邮箱联系删除。
unsafe包golang是一种静态的强类型的语言,所有的类型都是不能随意转换的,Go语言是不允许两个指针类型进行转换的。go官方是不推荐使用unsafe的操作
1、安装包下载进入Go官方下载界面下载并安装,安装时注意最好不要将其安装在C盘,我这里将它安装在D盘;2、环境变量配置安装包会自动添加环境变量,但是默认的Go工
gomodule的使用非常简单初始化go.modgomodinit整理依赖包gomodtidy如果想缓存到vendor目录gomodvendor执行命令之后都会
介绍go1.5+版本提供编译好的安装包,我们只需要解压到相应的目录,并添加一些环境变量的配置即可。Go语言的安装步骤下载安装包go1.7.linux-amd64
配置可能会随官方改变,本文仅供参考。1.下载安装GO的包到https://code.google.com/p/go/downloads/list下载对应操作系统