Go 1.11和1.12实现了对包管理的初步支持,Go的新依赖管理系统使依赖版本信息明确且易于管理。
Using Go Modules - The Go Blog

Golang

新的包管理模式有什么不同?

作为Go语言的推广者,常常被问到各种关于Go语言的基础特性问题。
其中,关于包管理方面的问题会让我非常尴尬,因为Go的包管理在1.11之前与Python、Node、Java比较起来真的只能算是“仅仅可用”而已。

因为:

$GOPATH/src

新的包管理模式解决了以上问题

  1. 自动下载依赖包
  2. 项目不必放在GOPATH/src内了
  3. 项目内会生成一个go.mod文件,列出包依赖
  4. 所以来的第三方包会准确的指定版本号
  5. 对于已经转移的包,可以用replace 申明替换,不需要改代码

开始吧用一个小例子来说明问题!

准备工作

  1. 升级golang 版本到 1.12 Go下载
  2. 添加环境变量 GO111MODULEon 或者auto
GO111MODULE=auto

准备完毕,非常简单吧!!

创建一个项目

$GOPATH/src
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()
}
go get

但是,使用了新的包管理就不在需要这样做了

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 

这样,一个使用Go包管理方式创建项目的小例子就完成了。

那么,接下来,几个小问题来了

问题一:依赖的包下载到哪里了?还在GOPATH里吗?

$GOPATH/pkg/mod
$GOPATH/pkg/modgithub.com/astaxie/beego@v1.11.1

问题二: 依赖包的版本是怎么控制的?

$GOPATH/pkg/modgithub.com/astaxie/beego@v1.11.1$GOPATH/pkg/mod

版本是在go.mod中指定的。

如果,在go.mod中没有指定,go命令会自动下载代码中的依赖的最新版本,本例就是自动下载最新的版本。

latest

依赖包的版本号是什么? 是包的发布者标记的版本号,格式为 vn.n.n (n代表数字),本例中的beego的历史版本可以在其代码仓库release看到Releases · astaxie/beego · GitHub

如果包的作者还没有标记版本,默认为 v0.0.0

问题三: 可以把项目放在$GOPATH/src下吗?

GO111MODULE=auto
$GOPATH/src$GOPATH/src$GOPATH/src

问题三: 依赖包中的地址失效了怎么办?比如 golang.org/x/… 下的包都无法下载怎么办?

在go快速发展的过程中,有一些依赖包地址变更了。
以前的做法

  1. 修改源码,用新路径替换import的地址
  2. git clone 或 go get 新包后,copy到$GOPATH/src里旧的路径下

无论什么方法,都不便于维护,特别是多人协同开发时。

使用go.mod就简单了,在go.mod文件里用 replace 替换包,例如

replace golang.org/x/text => github.com/golang/text latest
$GOPATH/pkg/mod/golang.org/x/text

问题四: init生成的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()
}

问题五:以前老项目如何用新的包管理

$GOPATH/srcgo mod init + 模块名称go buildgo run

关于Go 1.12的包管理介绍大致就到此了

根据官方的说法,从Go 1.13开始,模块管理模式将是Go语言开发的默认模式。

所以,Pick起来吧!

有问题或者需要讨论的朋友,可以给我留言,共同学习,一起进步

晓代码公众号