置信看我文章的文章的童鞋,golang 版本曾经是 1.3 版本以上。如果你的版本还停留在 1.3 以下,那这篇文章能够做为你的晋升之法。
go moudle 的前世今生
前世 -gopath
gopath 是什么
GOPATH 是什么,置信曾经不必我再多说什么了。大家深受残害多年,应该曾经有所领会。在 v.1.11 版本之前,装置 GO 必定要在环境变量中配置GoPath
, 咱们能够简略的将其了解成是工作目录。目录构造如下
— bin 寄存编译后生成的二进制可执行文件
— pkg 寄存编译后生成的 .a
文件
— src 寄存我的项目的源代码,能够是你本人写的代码,也能够是你 go get 下载的包
将你的包或者他人的包全副放在 $GOPATH/src
目录下进行治理的形式,咱们称之为 GOPATH 模式。
gopath 有什么样的问题?
版本治理问题
GOPATH 基本没有版本的概念,如果你所利用的库须要降级,那就是全局降级,所以波及这个库的服务在下一次编译中都会应用新的库,这是一件很危险的事件。版本治理十分重要,本人应该治理好本人的援用库。
协同开发问题
当其余的开发者 get 到源码进行批改的时候,你无奈保障他下载的包是不是你所冀望的版本,这及有可能导致服务出错,且很难查找起因。
今生 -GoMoudle
go modules 在 v1.11 版本正式推出,在公布的 v1.14 版本中,官网正式发话,称其曾经足够成熟,能够利用于生产上。
从 v1.11 开始,go env
多了个环境变量:GO111MODULE
,这里的 111,其实就是 v1.11 的象征标记,go 里如同很喜爱这样的命名形式,比方当初 vendor 呈现的时候,也多了个 GO15VENDOREXPERIMENT
环境变量,其中 15,示意的 vendor 是在 v1.5 时才诞生的。
GO111MODULE
是一个开关,通过它能够开启或敞开 go mod 模式。
它有三个可选值:off
、on
、auto
,默认值是auto
。
GO111MODULE=off
禁用模块反对,编译时会从GOPATH
和vendor
文件夹中查找包。GO111MODULE=on
启用模块反对,编译时会疏忽GOPATH
和vendor
文件夹,只依据go.mod
下载依赖。GO111MODULE=auto
,当我的项目在$GOPATH/src
外且我的项目根目录有go.mod
文件时,主动开启模块反对。
go mod 呈现后,GOPATH(必定没人应用了)和 GOVENDOR 将会且正在被逐渐淘汰,然而若你的我的项目依然要应用那些行将过期的包依赖治理计划,请留神将 GO111MODULE 置为 off。
具体怎么设置呢?能够应用 go env 的命令,如我要开启 go mod,就应用这条命令
go env -w GO111MODULE=”on”
go mod 应用
go mod 不再依附 $GOPATH,使得它能够脱离 GOPATH 来创立我的项目
你能够在你电脑的任意地位创立一个文件夹 go_demo
应用 go mod 命令初始化,此时目录下只有 2 个文件,go.mod 是执行命令后生成的文件。
go mod init go_demo
文件 main.go
解释:引入一个 now 的工夫解决库,输入工夫
package main
import (
“fmt”
“github.com/jinzhu/now”
)
func main() {
fmt.Println(“hello world”, now.BeginningOfDay())
}
go.mod 内容
module go_demo
go 1.15
require github.com/jinzhu/now v1.1.1
内容解释:
- 第一行:模块的援用门路
- 第二行:我的项目应用的 go 版本
- 第三行:我的项目所需的间接依赖包及其版本
-
- *
此时咱们在命令行执行 go build
进行编译, 发现多了一个 go.sum 文件,那么这个文件又是什么?
go.sum 文件相比 go.mod 就比较复杂了。尽管内容多,然而也不难理解。
每一行都是由 模块门路
, 模块版本
, 哈希测验值
组成,其中哈希测验值是用来保障以后缓存的模块不会被篡改。hash 是以h1:
结尾的字符串,示意生成 checksum 的算法是第一版的 hash 算法(sha256)。
go.mod 和 go.sum 是 go modules 版本治理的指导性文件,因而 go.mod 和 go.sum 文件都应该提交到你的 Git 仓库中去,防止其他人应用你写我的项目时,从新生成的 go.mod 和 go.sum 与你开发的基准版本的不统一。
go mod 的益处
相比 gopath
的形式,go mod
的益处不言而喻。你不用为了版本依赖吃力头脑,模块化主动帮你做好了。这就有点 C# 中 Nuget 的滋味,node 的 npm 的感觉。开发者不应为了这种事件操心,而应该专一于编码问题。
go mod 命令应用
罕用
go mod init
:初始化 go mod,生成 go.mod 文件,后可接参数指定 module 名,下面曾经演示过。
go mod download
:手动触发下载依赖包到本地 cache(默认为 $GOPATH/pkg/mod
目录)
go list -m -json all
:以 json 的形式打印依赖详情
不罕用
go mod graph
:打印我的项目的模块依赖构造go mod tidy
:增加短少的包,且删除无用的包go mod verify
:校验模块是否被篡改过go mod why
:查看为什么须要依赖go mod vendor
:导出我的项目所有依赖到 vendor 下go mod edit
:编辑 go.mod 文件
如何对待 go moudle 并利用于工作
go mode 形式必定是 举荐 的一种形式,如果不是基于历史我的项目 - 应用 GOPATH,举荐尽快应用 go mod 形式,这能让你省去很多糟心的事件。然而如果公司的我的项目还有不少就是基于 gopath 形式的,那你也不要焦急,gopath 的旧我的项目也是反对切换成 go mod 模式的,形式也很简略,大家动动小手,一百度就能够。当然正式的切换必定是须要领导批准的,毕竟工作零碎随便切换还是有危险的。
参考文章
一文搞懂 Go Modules
对于我
作者博客 | 文章首发
最初
本文到此结束,心愿对你有帮忙 ????
如果还有什么疑难或者倡议,能够多多交换,原创文章,文笔无限,满腹经纶,文中若有不正之处,万望告知。
更多精彩技术文章汇总在我的 公众号【程序员工具集]】,继续更新,欢送关注订阅珍藏。