拜拜了,GOPATH君!新版本Golang的包管理入门教程
Go 1.11和1.12实现了对包管理的初步支持,Go的新依赖管理系统使依赖版本信息明确且易于管理。
Using Go Modules - The Go Blog
新的包管理模式有什么不同?
作为Go语言的推广者,常常被问到各种关于Go语言的基础特性问题。
其中,关于包管理方面的问题会让我非常尴尬,因为Go的包管理在1.11之前与Python、Node、Java比较起来真的只能算是“仅仅可用”而已。
因为:
- 在不使用额外的工具的情况下,Go的依赖包需要手工下载,
- 第三方包没有版本的概念,如果第三方包的作者做了不兼容升级,会让开发者很难受
- 协作开发时,需要统一各个开发成员本地
$GOPATH/src
下的依赖包 - 引用的包引用了已经转移的包,而作者没改的话,需要自己修改引用。
- 第三方包和自己的包的源码都在src下,很混乱。对于混合技术栈的项目来说,目录的存放会有一些问题
新的包管理模式解决了以上问题
- 自动下载依赖包
- 项目不必放在GOPATH/src内了
- 项目内会生成一个go.mod文件,列出包依赖
- 所以来的第三方包会准确的指定版本号
- 对于已经转移的包,可以用replace 申明替换,不需要改代码
开始吧用一个小例子来说明问题!
准备工作
- 升级golang 版本到 1.12 Go下载
- 添加环境变量 GO111MODULE 为 on 或者auto
GO111MODULE=auto
准备完毕,非常简单吧!!
创建一个项目
首先,在$GOPATH/src
路径外的你喜欢的地方创建一个目录,cd 进入目录,新建一个hello.go文件,内容如下
package main
import (
"fmt"
)
func main() {
fmt.Println("Hello, world!")
}
初始化模块
在当前目录下,命令行运行 go mod init + 模块名称 初始化模块
go mod init hello
运行完后,会在当前项目目录下生成一个go.mod 文件,这是一个关键文件,之后的包的管理都是通过这个文件管理。
官方说明:除了go.mod之外,go命令还维护一个名为go.sum的文件,其中包含特定模块版本内容的预期加密哈希
go命令使用go.sum文件确保这些模块的未来下载检索与第一次下载相同的位,以确保项目所依赖的模块不会出现意外更改,无论是出于恶意、意外还是其他原因。 go.mod和go.sum都应检入版本控制。
go.sum 不需要手工维护,所以可以不用太关注。
生成出来的文件包含模块名称和当前的go版本号
module hello
go 1.12
注意:子目录里是不需要init的,所有的子目录里的依赖都会组织在根目录的go.mod文件里
来吧,搞点小事情,看看go.mod怎么工作的
接下来,让你的项目依赖一下第三方包
以大部分人都熟悉的beego为例吧!
修改Hello.go文件:
package main
import "github.com/astaxie/beego"
func main() {
beego.Run()
}
按照过去的做法,要运行hello.go需要执行go get
命令 下载beego包到 $GOPATH/src
但是,使用了新的包管理就不在需要这样做了
直接 go run hello.go
稍等片刻… go 会自动查找代码中的包,下载依赖包,并且把具体的依赖关系和版本写入到go.mod和go.sum文件中。
查看go.mod,它会变成这样:
module hello
go 1.12
require github.com/astaxie/beego v1.11.1
require
关键子是引用,后面是包,最后v1.11.1 是引用的版本号
这样,一个使用Go包管理方式创建项目的小例子就完成了。
那么,接下来,几个小问题来了
问题一:依赖的包下载到哪里了?还在GOPATH里吗?
不在。
使用Go的包管理方式,依赖的第三方包被下载到了$GOPATH/pkg/mod
路径下。
如果你成功运行了本例,可以在您的$GOPATH/pkg/mod
下找到一个这样的包 github.com/astaxie/beego@v1.11.1
问题二: 依赖包的版本是怎么控制的?
在上一个问题里,可以看到最终下载在$GOPATH/pkg/mod
下的包 github.com/astaxie/beego@v1.11.1
最后会有一个版本号 1.11.1,也就是说,$GOPATH/pkg/mod
里可以保存相同包的不同版本。
版本是在go.mod中指定的。
如果,在go.mod中没有指定,go命令会自动下载代码中的依赖的最新版本,本例就是自动下载最新的版本。
如果,在go.mod用require语句指定包和版本 ,go命令会根据指定的路径和版本下载包,
指定版本时可以用latest
,这样它会自动下载指定包的最新版本;
依赖包的版本号是什么? 是包的发布者标记的版本号,格式为 vn.n.n (n代表数字),本例中的beego的历史版本可以在其代码仓库release看到Releases · astaxie/beego · GitHub
如果包的作者还没有标记版本,默认为 v0.0.0
问题三: 可以把项目放在$GOPATH/src下吗?
可以。
但是go会根据GO111MODULE的值而采取不同的处理方式
默认情况下,GO111MODULE=auto
自动模式
- auto 自动模式下,项目在
$GOPATH/src
里会使用$GOPATH/src
的依赖包,在$GOPATH/src外,就使用go.mod 里 require的包 - on 开启模式,1.12后,无论在
$GOPATH/src
里还是在外面,都会使用go.mod 里 require的包 - off 关闭模式,就是老规矩。
问题三: 依赖包中的地址失效了怎么办?比如 golang.org/x/… 下的包都无法下载怎么办?
在go快速发展的过程中,有一些依赖包地址变更了。
以前的做法
- 修改源码,用新路径替换import的地址
- git clone 或 go get 新包后,copy到$GOPATH/src里旧的路径下
无论什么方法,都不便于维护,特别是多人协同开发时。
使用go.mod就简单了,在go.mod文件里用 replace 替换包,例如
replace golang.org/x/text => github.com/golang/text latest
这样,go会用 github.com/golang/text 替代golang.org/x/text,原理就是下载github.com/golang/text 的最新版本到 $GOPATH/pkg/mod/golang.org/x/text
下。
问题四: init生成的go.mod的模块名称有什么用?
本例里,用 go mod init hello 生成的go.mod文件里的第一行会申明module hello
因为我们的项目已经不在$GOPATH/src
里了,那么引用自己怎么办?就用模块名+路径。
例如,在项目下新建目录 utils,创建一个tools.go文件:
package utils
import “fmt”
func PrintText(text string) {
fmt.Println(text)
}
在根目录下的hello.go文件就可以 import “hello/utils” 引用utils
package main
import (
"hello/utils"
"github.com/astaxie/beego"
)
func main() {
utils.PrintText("Hi")
beego.Run()
}
问题五:以前老项目如何用新的包管理
- 如果用auto模式,把项目移动到
$GOPATH/src
外 - 进入目录,运行
go mod init + 模块名称
go build
或者go run
一次
关于Go 1.12的包管理介绍大致就到此了
根据官方的说法,从Go 1.13开始,模块管理模式将是Go语言开发的默认模式。
所以,Pick起来吧!
有问题或者需要讨论的朋友,可以给我留言,共同学习,一起进步
拜拜了,GOPATH君!新版本Golang的包管理入门教程的更多相关文章
- nexus 3.17.0 做为golang 的包管理工具
nexus 3.17.0 新版本对于go 包管理的支持是基于go mod 的,同时我们也需要一个athens server 然后在nexus 中配置proxy 类型的repo 参考配置 来自官方的配置 ...
- golang的包管理---vendor/dep等
首先关于vendor 1 提出问题 我们知道,一个工程稍大一点,通常会依赖各种各样的包.而Go使用统一的GOPATH管理依赖包,且每个包仅保留一个版本.而不同的依赖包由各自的版本工具独立管理,所以当所 ...
- Golang学习--包管理工具glide
上一篇文章中我们已经成功的运行了go的代码,这是我们迈出的最基础的一步. 一个项目通常会依赖很多外部的库,当依赖的库比较多的时候,手工管理就会比较麻烦,这个时候就需要包管理工具出场了,帮你管理好所有依 ...
- Golang Vendor 包管理工具 glide 使用教程
Glide 是 Golang 的 Vendor 包管理器,方便你管理 vendor 和 verdor 包.类似 Java 的 Maven,PHP 的 Composer. Github:https:// ...
- [golang] Glide 包管理
一.概述 golang的包管理工具有很多,本篇幅主要介绍glide进行包管理. 二.安装及命令介绍 go get github.com/Masterminds/glide glide create|i ...
- [golang] Glide 包管理工具,在windows10 64位系统上的bug修复方案
bug重现 [ERROR] Unable to export dependencies to vendor directory: Error moving files: exit status 1. ...
- golang包管理解决之道——go modules初探
golang的包管理是一直是为人诟病之处,从golang1.5引入的vendor机制,到准官方工具dep,目前为止还没一个简便的解决方案. 不过现在go modules随着golang1.11的发布而 ...
- Golang Vendor 包机制 及 注意事项
现在的 Go 版本是 1.8,早在 1.5 时期,就有了 Vendor 包机制,详情可查看博文:“理解 Go 1.5 vendor”. 遇到的问题 个人在使用 Glide 管理 Vendor 包时(附 ...
- Glide Golang包管理
Golang的包管理乱得不行,各种工具横空出世,各显神通啊.用了几个下来,发现 Glide 是比较好用的,使用了 vender 来进行管理,多个开发环境的版本不冲突,功能强大,配置文件也足够简单. 初 ...
随机推荐
- dp优化-四边形不等式(模板题:合并石子)
学习博客:https://blog.csdn.net/noiau/article/details/72514812 看了好久,这里整理一下证明 方程形式:dp(i,j)=min(dp(i,k)+dp( ...
- 省队集训 Day1 残缺的字符串
[题目大意] 双串带通配符匹配. $|S|, |T| \leq 5 * 10^5$ TL: 2s [题解] 参考bzoj 4503 可以设计如下函数 A[i] * B[i] * (A[i] - B[i ...
- bzoj 2144: 跳跳棋——倍增/二分
Description 跳跳棋是在一条数轴上进行的.棋子只能摆在整点上.每个点不能摆超过一个棋子.我们用跳跳棋来做一个简单的游戏:棋盘上有3颗棋子,分别在a,b,c这三个位置.我们要通过最少的跳动把他 ...
- 【NOIP】提高组2016 愤怒的小鸟
[题意]Universal Online Judge [算法]状态压缩型DP [题解]看数据范围大概能猜到是状压了. 根据三点确定一条抛物线,枚举两个点之间的抛物线,再枚举有多少点在抛物线上(压缩为状 ...
- 【BZOJ】1419 Red is good
[算法]期望DP [题解]其实把状态表示出来就是很简单的期望DP. f[i][j]表示i张红牌,j张黑牌的期望. i=0时,f[0][j]=0. j=0时,f[i][0]=i. f[i][j]=max ...
- 【CODEVS】1281 Xn数列
[算法]矩阵快速幂 [题解]T*A(n-1)=A(n)矩阵如下: a 1 * x(n-1) 0 = xn 0 0 1 c 0 c 0 防止溢出可以用类似快速幂的快速乘. ...
- 【BZOJ】1726 [Usaco2006 Nov]Roadblocks第二短路
[算法]最短路(spfa) 次短路 [题解] 正反跑两次SPFA,然后枚举每一条边,如果起点到一个端点的最短路+另一个端点到终点的最短路+长度 ≠ 最短路,则和答案比较,保存最小值. #include ...
- Linux 命令行生成密码的 10 种方式
内容来自: 10 Ways to Generate a Random Password from the Linux Command Line Linux 好玩的事儿是达成一件事情可以用上百种方式. ...
- Mac 上真机调试cocos2d-x-3.16的test程序
文章比较长,一个算是新手又不是新手的程序员的解决过程. 一 xcode中打开项目 首先,下载完成cocos2d-x-3.16之后,解压,然后在根目录build目录下双击cocos2d_tests.xc ...
- Hadoop和大数据:60款顶级开源工具(山东数漫江湖)
说到处理大数据的工具,普通的开源解决方案(尤其是Apache Hadoop)堪称中流砥柱.弗雷斯特调研公司的分析师Mike Gualtieri最近预测,在接下来几年,“100%的大公司”会采用Hado ...