使用 Go Modules 管理依赖：简明教程

一、GoLang 中包的介绍和定义

• 包（package）是多个 Go 源码的集合，是一种高级的代码复用方案
• Go 语言为我们提供了很多内置包，如 fmt、strconv、strings、sort、errors、times、encoding/json、os、io 等
• Golang 中的包可以分为三种，1、系统内置包2、自定义包3、第三方包
  1. 系统内置包
     1. fmt、strconv、strings、sort、errors、time、encoding/json、os、io 等
  2. 自定义包
     1. 开发者自己写的包
  3. 第三方包
     1. 属于自定义包的一种，需要下载安装到本地后才可以使用

二、GoLang 包管理工具 go mod

• 在 Golang1.11 版本之前如果我们摇自定义包的话必须把项目放在 GOPATH 目录
• Go1.11版本之后无需手动配置环境变量，使用 go mod 管理项目
• 也不需要非得吧项目放到 GOPATH 指定目录下，你可以在你磁盘的任何位置新建一个项目
• Go1.13 以后可以切滴不要 GOPATH 了

1、go mod init 初始化项目

• 实际项目开发中我们首先要在我们项目目录中用 go mod命令生成一个go.mod文件管理我们项目的依赖
• 比如我们的 golang 项目文件要放在了 itying 这个文件夹，这个时候我们需要在 itying 文件里面使用 gomode 命令生产一个 go.mod文件
• go.mod文件一旦创建后，它的内容将会被 go toolchain 全面掌控
• go toolchain 会在各类命令执行时，比如 go get、go build、go mod 等修改和维护 go.mod文件
• go.mod提供了 module，require、replace 和 exclude 四个命令
  • module 语句指定包的名字（路径）
  • require 语句指定的依赖项模块
  • replace 语句可以体会依赖项模块
  • exclude 语句可以忽略依赖项模块

2、go mod 常用命令

|----------|---------------------------------------------------------|
| 命令 | 说明 |
| download | download modules to local cache(下载依赖包) |
| edit | edit go.mod from tools or scripts（编辑go.mod) |
| graph | print module requirement graph (打印模块依赖图) |
| verify | initialize new module in current directory（在当前目录初始化mod） |
| tidy | add missing and remove unused modules(拉取缺少的模块，移除不用的模块) |
| vendor | make vendored copy of dependencies(将依赖复制到vendor下) |
| verify | verify dependencies have expected content (验证依赖是否正确） |
| why | explain why packages or modules are needed(解释为什么需要依赖) |

三、GoLang 中自定义包

• 包（package）是多个 Go 源码的集合，一个包可以简单理解为一个存放多个.go文件的文件夹
• 改文件夹下面的所有 go 文件都要在代码的第一行添加如下代码，声明改文件归属的包

package 包名

1、初始化项目

mkdir Demo

cd Demo

go mod init Demo

2、Demo/calc/calc.go

package main

import {
    c "Demo/calc"    // c是取的别名
	"fmt"
}

func main() {
	sum := c.Add(10, 2)
	fmt.Println(sum)                  //12
	sub := c.Sub(10, 2)
	fmt.Println(sub)                  // 8
}
func init() {   //main包中init函数 优先于 main函数
	fmt.Println("main init...")
}
/*
main init...
12
8
 */

四、init（）初始化函数

1、init（）函数介绍

• 在 Go 语言程序执行时导入包语句会自动触发包内部 init（）函数的调用
• 需要注意的是：init（）函数没有参数也没有返回值
• init（）函数在程序运行是自动被调用执行，不能在代码中主动调用它

2、init（）函数执行顺序

• Go 语言包会从 main 包开始检查其导入的所有包，每个包中又可能导入了其他的包
• Go 编译器由此构建出一个树状的包引用关系，再根据引用顺序决定编译顺序，依次编译这些包的代码
• 在运行时，被最后导入的包会最先初始化并调用奇 inti（）函数，如下图示

五、Golang 中使用第三方包

1、查找 golang 的第三方包

• 我们可以在Go Packages - Go Packages查找看常见的 golang 第三方包

2、安装这个包

• 第一种方法：go get 包名称（全局）

go get github.com/shopspring/decimal

• 第二种方法：go mod download （全局）
  • 依赖包会自动下载到$GOPATH/pkg/mod，多个项目可以共享缓存的 mod
  • 注意使用 go mod download 的上海首先需要在你的项目里面引入第三方包

go mod  download

• 第三种方法：go mod vendor 将依赖复制到当前项目的 vendor 在（本项目）
  • 将依赖复制到当前项目的 vendor 下
  • 注意：使用go mod vendor的时候首先需要在你的项目里面引入第三方包

go mod vendor

3、看文档使用这个包

• 包安装完毕后我们就可以看文档使用这个包了..