什么是go modules？

go modules 是 golang 1.11 新加的特性。Modules官方定义为：

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

而go mod就是用来管理包的命令。

设置GO111MODULES参数

go mod命令

（可以使用go help mod查看）

创建一个go.mod管理自定义的包

1. 创建一个greetings目录
2. 创建greetings.go代码文件，内容如下：

package greetings

import "fmt"

// ***go语言包中的函数如果想要被其他包调用，必须以大写字母开头***
// Hello returns a greeting for the named person.
func Hello(name string) string {
    // Return a greeting that embeds the name in a message.
    message := fmt.Sprintf("Hi, %v. Welcome!", name)
    return message
}

在greetings同级目录中创建hello.go，结构如下

// greeting是目录，hello.go是文件，在一个目录层级中
Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----         2022/4/17     21:30                greetings
-a----         2022/4/17     21:33            152 hello.go

此时没有使用go modules，如果想要像go src里的标准库一样引用自定义的Hello()函数，将会报错，如下图：

image.png

使用go mod init命令创建module

在greetings目录下执行go mod init example.com/greetings命令
此时该目录下生成了一个go.mod文件，内容如下：

module example.com/greetings

go 1.17

example.com/greetings是module的路径，用于golang跟踪greetings包所在的位置。
这个时候再执行greetings目录同级的hello.go就能够成功调用Hello()函数

package main

import (
    "fmt"

    "example.com/greetings"
)

func main() {
    name := "lisi"
    msg := greetings.Hello(name)
    fmt.Println(msg)
}

从另一个module调用greetings.Hello()

现在，在greetings的同级目录下创建一个hello文件夹，在hello目录下中使用go mod init example.com/hello初始化一个新的module。命令和目录结构如下：

cd ..
mkdir hello
cd hello
go mod init example.com/hello

// greetings和hello都是目录
Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----         2022/4/17     21:30                greetings
-a----         2022/4/17     21:33            152 hello.go
d-----         2022/4/17     21:41                hello

把前面编写的hello.go移入hello目录下，此时是两个module（hello&greetings），hello.go又无法调用greetings.Hello()函数了。报错如下：

hello.go:6:2: no required module provides package example.com/greetings; to add it:
go get example.com/greetings

go get会从指定的url下载对应的包，如果greetings包已经发布，执行该命令可以下载对应的包。但是目前greetings包还在本地未发布，则需要通过以下步骤调用：

1. 使用以下命令编辑go.mod文件
   go mod edit -replace example.com/greetings=../greetings
   现在hello module的go.mod文件如下：

module example.com/hello

go 1.17

replace example.com/greetings => ../greetings

2. 执行go mod tidy同步go.mod的参数

\hello> go mod tidy
go: found example.com/greetings in example.com/greetings v0.0.0-00010101000000-000000000000

此时hello/go.mod的内容如下：

module example.com/hello

go 1.17

replace example.com/greetings => ../greetings

require example.com/greetings v0.0.0-00010101000000-000000000000

最后hello.go可以成功调用greetings.Hello()函数