概述
Go Modules模式
(1)go mod 命令
命令 | 作用 |
---|---|
go mod init | 生成 go.mod 文件 / 在当前文件夹下初始化一个新的 go.mod 文件 |
go mod download | 下载 go.mod 文件中指明的所有依赖 / 下载依赖的module到本地cache |
go mod tidy | 整理现有的依赖 / 增加失去的 module,去掉未用的module |
go mod graph | 查看现有的依赖结构 |
go mod edit | 编辑 go.mod 文件 |
go mod vendor | 导出项目所有的依赖到 vendor 目录 / 将依赖复制到vendor下 |
go mod verify | 校验一个模块是否被篡改过 / 校验依赖,检查下载到第三方库有没有本地修改,如果有修改,则返回非0,否则验证成功。 |
go mod why | 查看为什么需要依赖某模块 / 解释为什么需要需要依赖 |
(2)go mod 环境变量
可以通过 go env
命令来进行查看
GO111MODULE="on"
GOPROXY="https://goproxy.cn,direct"
GOROOT="..."
GOSUMDB="sum.golang.org"
GOTMPDIR=""
...
GO111MODULE
Go 语言提供了GO111MODULE这个环境变量来作为 Go modules 的开关,其允许设置以下参数:
- auto:只要项目包含了 go.mod 文件的话启用 Go modules。
- on:启用 Go modules,推荐设置。
- off:禁用 Go modules,不推荐。
可以通过 go env -w GO111MODULE=on
来设置。
GOPROXY
这个环境变量主要是用于设置 Go 模块代理(Go module proxy),其作用是用于使 Go 在后续拉取模块版本时直接通过镜像站点来快速拉取。
- GOPROXY 的默认值是:https://proxy.golang.org,direct
proxy.golang.org
国内访问不了,需要设置国内的代理- 阿里云:https://mirrors.aliyun.com/goproxy/
- 七牛云:https://goproxy.cn,direct
go env -w GOPROXY=https://proxy.golang.org,direct
direct的含义:指示符。指示go回源到模块版本的原地址去拉取。
比如一个模块 “github.com/xxx/json”,首先会到
https://proxy.golang.org
中去抓取,如果找不到,会去github.com/xxx/json
源本身去拉取。
--------### GOPRIVATE
GONOPROXY/GONOSUMDB/GOPRIVATE
,通过设置GOPRIVATE即可。
设置方式:
go env -w GOPRIVATE="git.example.com,github.com/aceld/zinx"
# git.example.com 比如是公司内部的仓库的名称,或者是私有仓库
# 设置了这个参数,即当我们导包的时候,不会去GOPROXY的地址下载,即设置了GOPRIVATE,会覆盖GOPROXY和GOSUMDB
# 可以通过通配符去设置
go env -w GOPRIVATE="*.example.com"
# 凡是这个后缀的模块路径,都会走这个私有仓库,不会经过GOPROXY
或者通过 Linux export 环境方式也可以设置
使用 Go Modules 初始化项目
(1)开启 Go Modules
go env -w GO111MODULE=on
又或是可以通过直接设置系统环境变量(写入对应的~/.bash_profile 文件亦可)来实现这个目的:
export GO111MODULE=on
(2)初始化项目
创建项目目录
mkdir -p $HOME/aceld/modules_test
cd $HOME/aceld/modules_test
执行 Go modules 初始化
go mod init github.com/aceld/modules_test
# github.com/aceld/modules_test —— 这个名称决定了你导包的名称,是你本项目的名称
# 创建了一个 go.mod 文件,出现这个,表示创建成功
在执行 go mod init 命令时,我们指定了模块导入路径为 github.com/aceld/modules_test。接下来我们在该项目根目录下创建 main.go 文件,如下:
vim main.go
内容为:
import (
"fmt"
"github.com/aceld/zinx/ziface"
"github.com/aceld/zinx/znet"
)
//ping test 自定义路由
type PingRouter struct {
znet.BaseRouter
}
//Ping Handle
func (this *PingRouter) Handle(request ziface.IRequest) {
//先读取客户端的数据
fmt.Println("recv from client : msgId=", request.GetMsgID(), ", data=", string(request.GetData()))
//再回写ping...ping...ping
err := request.GetConnection().SendBuffMsg(0, []byte("ping...ping...ping"))
if err != nil {
fmt.Println(err)
}
}
func main() {
//1 创建一个server句柄
s := znet.NewServer()
//2 配置路由
s.AddRouter(0, &PingRouter{})
//3 开启服务
s.Serve()
}
下载包
(base) ➜ modules_test ls
go.mod main.go
(base) ➜ modules_test pwd
/Users/username/aceld/modules_test
(base) ➜ modules_test go get github.com/aceld/zinx/znet
go: downloading github.com/aceld/zinx v1.0.1
go: added github.com/aceld/zinx v1.0.1
(base) ➜ modules_test go get github.com/aceld/zinx/ziface
生成 go.sum
启动程序
go run main.go
现在的
go.mod
文件内容:module github.com/aceld/modules_test go 1.18 require github.com/aceld/zinx v1.0.1 // indirect // 导入的包。 版本号。 indirect:表示间接依赖,在代码中依赖的是zinx下的ziface和znet,并没有依赖zinx本身
go.sum
文件:作用是当前的库是完整的库,校验是正确的。
表示依赖的模块名称、版本号、h1+hash(go.mod h1+hash)
- h1+hash(没有go.mod):表示将目标文件的zip压缩包打开之后,针对所有文件校验和来生成的hash(库里所有的包的值统一做哈希,保证所有文件的完整性)
- 如果不存在,可能表示依赖到库可能用不上
- go.mod h1+hash:对mod做了哈希
下载的包实际上被下载到哪儿了呢?
/Users/username/goproject/pkg/mod/github.com/aceld/zinx@v1.0.1
修改项目模块的版本依赖关系
go mod edit -replace=zinx@1.1.0=zinx@1.2.0
安装包
1、go get (全局)
- 受网络原因限制
2、go download (全局)
依赖包会自动下载到 $GOPATH/pkg/mod,多个项目可以共享缓存的mod,注意使用go mod download 的时候首先需要在你的项目里面引入第三方包。
3、go mod vender(本项目)(主用)
- 将依赖复制到当前项目的vendor下(本项目)
【注意】
使用 go mod vendor 的时候首先需要在你的项目里面引入第三方包
函数init执行顺序
init函数会自动执行
main => import A => import B => import C
C.init() => B.init() => A.init() => main.init()
最后
以上就是虚拟鸡翅为你收集整理的Go Modules模式Go Modules模式使用 Go Modules 初始化项目的全部内容,希望文章能够帮你解决Go Modules模式Go Modules模式使用 Go Modules 初始化项目所遇到的程序开发问题。
如果觉得靠谱客网站的内容还不错,欢迎将靠谱客网站推荐给程序员好友。
发表评论 取消回复