转载请注明出处:
go module是go官方自带的go依赖管理库,在1.13版本正式推荐使用 go module可以将某个项目(文件夹)下的所有依赖整理成一个 go.mod 文件,里面写入了依赖的版本等 使用go module之后我们可不用将代码放置在src下 使用 go module 管理依赖后会在项目根目录下生成两个文件 go.mod(会记录当前项目的所依赖)和go.sum(记录每个依赖库的版本和哈希值)
包管理工具go mod具有以下特性:
1)自动下载依赖包,即第三方包。
2)自定义包无须放在GOPATH设置的路径。
3)第三方包或自定义包写在go.mod文件中,通过go.mod文件管理包。
4)已经转移的第三方包或自定义包,在go.mod文件中使用replace替换,不需要修改代码。
5)对第三方包指定版本号。
GO111MODULE 是 Go 1.11 版本后引入的模块管理功能。使用 GO111MODULE 可以让 Go 语言项目获得更好的包管理和版本控制功能。 GO111MODULE 的配置有以下几种:
auto:在 $GOPATH/src 之外的项目和使用了 Go 1.11 之前的依赖管理方式的项目开启模块支持,其他项目不开启。当项目在 GOPATH/src
目录之外,并且项目根目录有 go.mod
文件时,才开启 go module
。
on:开启模块支持,无论项目是否在 $GOPATH/src 下。启用 go module
,编译时会忽略GOPATH
和vendor
文件夹,只根据go.mod
下载依赖,这种模式称作module-aware
模式,这种模式下,GOPATH
不再在build
时扮演导入的角色,但是尽管如此,它还是承担着存储下载依赖包的角色。它会将依赖包放在GOPATH/pkg/mod
目录下。
off:关闭模块支持,使用 GOPATH 和 vendor 目录作为依赖管理方式。 可以通过设置环境变量 GO111MODULE 或者在项目目录中创建 go.mod 文件来配置 GO111MODULE。
GO111MODULE=off
: 禁用 go module
,编译时会在vendor
目录下和GOPATH
目录中查找依赖包。也把这种模式叫GOPATH
模式
GOPATH是Go语言的工作目录,它是一个环境变量,用于指定Go语言源代码、依赖库和可执行文件的存放位置。在Go语言中,所有的源代码都必须存放在GOPATH目录下的src子目录中,所有的依赖库和可执行文件则分别存放在GOPATH目录下的pkg和bin子目录中
GOPATH的作用是指定Go语言源代码、依赖库和可执行文件的存放位置,并且在编译项目时自动查找相应的文件。
通过go env查看go环境相关的配置,可以看到 GO111MODULE 没有设置,默认为关闭off,项目的go依赖文件下载到 go path 目录中对应的src文件夹下:
GOROOT是Go语言的安装目录,它是一个环境变量,用于指定Go语言的安装路径。在Go语言中,所有的标准库都存放在GOROOT目录下的src子目录中,所有的可执行文件则存放在GOROOT目录下的bin子目录中。
set GO111MODULE=on set GO111MODULE=auto
go env -w GO111MODULE=on
go env -w GO111MODULE=auto
linux配置
# 开启模块支持 export GO111MODULE=on # 关闭模块支持 export GO111MODULE=off
go mod init <module-name>
其中,module-name 是你的项目名称。 管理依赖仓库: 当 GO111MODULE 开启时,Go 语言会优先从 go.mod 文件中的模块信息中获取依赖库的版本信息,如果没有找到,则会去 GOPATH 和 vendor 目录下查找依赖库。 使用 go get 命令或者直接修改 go.mod 文件来管理依赖库的版本信息。例如:
# 使用 go get 命令安装依赖库(会自动更新 go.mod 文件) go get -u github.com/gin-gonic/gin # 直接修改 go.mod 文件 require ( github.com/gin-gonic/gin v1.6.3 )
可以使用以下命令来更新依赖库:
go mod tidy # 移除不需要的依赖库
go mod vendor # 将依赖库复制到 vendor 目录下
go mod download # 下载依赖库
如在mygo项目的目录下,输入go mod init mygo 指令即可在mygo下创建go.mod文件
在mygo的go.mod中设置自定义包mpb的信息,mygo的go.mod代码如下
module mygo go 1.18 require ( mpb v0.0.0 ) replace mpb => ./mpb
go.mod的代码说明如下:
1)module mygo代表当前go.mod文件隶属于文件夹mygo。
2)go 1.18代表当前Go语言的版本信息。
3)require代表需要调用第三方包或自定义包,小括号里面一行代码代表一个包信息。
4)mpb v0.0.0代表包的信息,mpb是包名,v0.0.0是当前包的版本信息。
5)replace为require的包指定新的路径地址,常用于本地自定义包或第三方包的路径迁移,例如mpb => ./mpb代表自定义包mpb为当前路径的文件夹mpb。