go.mod

（点击上方公众号，可快速关注）

什么是go.mod?

Go.mod是Golang1.11版本新引入的官方包管理工具用于解决之前没有地方记录依赖包具体版本的问题，方便依赖包的管理。

Go.mod其实就是一个Modules，关于Modules的官方定义为：

Modules是相关Go包的集合，是源代码交换和版本控制的单元。go命令直接支持使用Modules，包括记录和解析对其他模块的依赖性。Modules替换旧的基于GOPATH的方法，来指定使用哪些源文件。

Modules和传统的GOPATH不同，不需要包含例如src，bin这样的子目录，一个源代码目录甚至是空目录都可以作为Modules，只要其中包含有go.mod文件。

如何使用go.mod?

1.首先将go的版本升级为1.11以上

2.设置GO111MODULE

GO111MODULE

GO111MODULE有三个值：off, on和auto（默认值）。

GO111MODULE=off，go命令行将不会支持module功能，寻找依赖包的方式将会沿用旧版本那种通过vendor目录或者GOPATH模式来查找。

GO111MODULE=on，go命令行会使用modules，而一点也不会去GOPATH目录下查找。

GO111MODULE=auto，默认值，go命令行将会根据当前目录来决定是否启用module功能。这种情况下可以分为两种情形：

当前目录在GOPATH/src之外且该目录包含go.mod文件

当前文件在包含go.mod文件的目录下面。

go mod命令：

golang 提供了 go mod命令来管理包。go mod有以下命令：

go.mod如何在项目中使用？

1.首先我们要在GOPATH/src 目录之外新建工程，或将老工程copy到GOPATH/src 目录之外。

PS：go.mod文件一旦创建后，它的内容将会被go toolchain全面掌控。go toolchain会在各类命令执行时，比如go get、go build、go mod等修改和维护go.mod文件。

go.mod 提供了module, require、replace和exclude四个命令

module语句指定包的名字（路径）

require语句指定的依赖项模块

replace语句可以替换依赖项模块

exclude语句可以忽略依赖项模块

下面是我们建立了一个hello.go的文件:

package main

import (

"fmt"

)

func main() {

fmt.Println("Hello, world!")

}

2.在当前目录下，命令行运行 go modinit + 模块名称初始化模块, 即go mod init hello,

运行完之后，会在当前目录下生成一个go.mod文件，这是一个关键文件，之后的包的管理都是通过这个文件管理。

官方说明：除了go.mod之外，go命令还维护一个名为go.sum的文件，其中包含特定模块版本内容的预期加密哈希,go命令使用go.sum文件确保这些模块的未来下载检索与第一次下载相同的位，以确保项目所依赖的模块不会出现意外更改，无论是出于恶意、意外还是其他原因。 go.mod和go.sum都应入版本控制。

go.sum 不需要手工维护，所以可以不用太关注。

注意：子目录里是不需要init的，所有的子目录里的依赖都会组织在根目录的go.mod文件里

接下来，让我们的项目依赖一下第三方包:

如修改hello.go文件如下，按照过去的做法，要运行hello.go需要执行go get 命令下载gorose包到 $GOPATH/src

package main

import (

"fmt"

"github.com/gohouse/gorose"

)

func main() {

fmt.Println("Hello, world!")

}

但是，使用了新的包管理就不在需要这样做了.

直接 go run hello.go

稍等片刻… go 会自动查找代码中的包，下载依赖包，并且把具体的依赖关系和版本写入到go.mod和go.sum文件中。

查看go.mod，它会变成这样：

module test

require (

github.com/gohouse/gorosev1.0.5

)

require 关键字是引用，后面是包，最后v1.11.1是引用的版本号

这样，一个使用Go包管理方式创建项目的小例子就完成了。

看完本文有收获？请转发分享更多人

因为分享是一种美德