GoWeb——Go Mod使用

1、Go Mod

Go 1.11 版本推出 modules，简称 mod，go mod的推出可以使我们更容易管理项目中所需要的模块。go mod 不再依靠 $GOPATH，使得它可以脱离 GOPATH 来创建项目。也就是你可以在你电脑的任意位置创建一个文件夹作为项目目录，然后使用 go mod 命令对目录进行初始化。

2、Go Mod模式

Go Modules 在 Go 1.11 和 Go 1.12 中有三个模式，根据环境变量 GO111MODULE进行配置：

• 默认模式（未设置该环境变量或 GO111MODULE=auto）
  Go 编译器在同时满足以下两个条件时使用 Go Mod
  1. 当前目录不在 GOPATH/src/ 下；
  2. 在当前目录或上层目录中存在 go.mod 文件；
• GOPATH 模式（GO111MODULE=off）
  Go 编译器从不使用 Go Mod。而会查找 vendor 目录和 GOPATH 以查找依赖项。
• Go Modules 模式（ GO111MODULE=on）
  Go 编译器只使用 Go Mod，GOPATH不再作为导入目录，但它还是会把下载的依赖储存在 GOPATH/pkg/mod 中，也会把 go install 命令的结果放在 GOPATH/bin 中。
  ​
  Go 1.13 及1.13以后版本默认使用 Go Mod 模式

3、Go Proxy设置

在项目开发中我们可以会用到很多第三方库，由于有很多库在境外网站访问非常慢或需要翻墙，从而导致下载失败，在Go 1.13及以后版本我们可以通过设置环境变量GOPRIVATE来控制代理从而方便下载第三方库

# 设置GOPROXY代理
go env -w GOPROXY=https://goproxy.cn,direct 
 
 
https://goproxy.cn  为代理地址 
 
direct 为特殊指示符，用于指示 Go 回源到模块版本的源地址去抓取，
       也就是说在proxy找不到的时候，会直接访问模块源码所在的地址
       比如github
 
 
#设置GOPRIVATE来跳过私有库，比如常用的Gitlab或Gitee，中间使用逗号分隔：
go env -w GOPRIVATE=*.gitlab.com,*.gitee.com
 
 
常用代理
 
阿里云         https://mirrors.aliyun.com/goproxy/
nexus社区      https://gonexus.dev
七牛云         https://goproxy.cn
goproxy.io    https://goproxy.io
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

4、Go Mod使用

4.1、设置项目目录

在非$GOPATH目录的任意地方创建一个文件夹，然后再终端执行 go mod init project_name进行初始化操作，成功之后会发现目录下会生产一个go.mod文件

查看go.mod内容：

module modtest

go 1.19
1
2
3

4.2、编写程序添加依赖库

在demo01目录下创建 main.go文件，并引入gin库，启动一个web服务，代码如下

package main

import (
	"github.com/gin-gonic/gin"
)

func main() {
	r := gin.Default()
	r.GET("/ping", func(c *gin.Context) {
		c.JSON(200, gin.H{
			"message": "pong",
		})
	})
	r.Run() //listen and serve on 0.0.0.0:8080
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

执行 go run main.go 运行代码会发现 go mod 会自动查找依赖自动下载,再查看 go.mod

module modtest

go 1.19

require github.com/gin-gonic/gin v1.9.1
1
2
3
4
5

go module 安装 package 的原則是先拉最新的 release tag，若无tag则拉最新的commit

go 会自动生成一个 go.sum 文件来记录 dependency tree

再次执行脚本 go run main.go发现跳过了检查并安装依赖的步骤。

可以使用命令 go list -m -u all 来检查可以升级的package，使用go get -u need-upgrade-package 升级后会将新的依赖版本更新到go.mod * 也可以使用 go get -u 升级所有依赖

4.3、go.mod命令

• module 表示模块名称（路径）
• require 依赖包列表及版本
• replace 替换依赖项模块
• exclude 忽略依赖项模块

上面截图中的 indirect 表示这个包是间接引用进来的

5、Go Mod命令