Go Modules 介紹

Modules是Go 1.11中新增的實(shí)驗(yàn)性功能，基于vgo演變而來(lái)，是一個(gè)新型的包管理工具。

Go 1.11 之前的包管理工具都是基于PATH或者vendor目錄，并不能很好的解決不同版本依賴問(wèn)題。Modules是在GOPATH之外一套新的包管理方式。使用Modules可以完全不依賴GOPATH。

注意：Go Modules 需要Go 1.11以上版本

使用指南

Example

1、在GOPATH之外創(chuàng)建一個(gè)目錄

$ mkdir -p /tmp/scratchpad/hello $ cd /tmp/scratchpad/hello

2、初始化Module

$ go mod init github.com/you/hello go: creating new go.mod: module github.com/you/hello

3、編輯hello.go

package main import (     "fmt"     "rsc.io/quote" ) func main() {     fmt.Println(quote.Hello()) }

4、編譯并運(yùn)行

$ go build $ ./hello Hello, world.

注意: go build 會(huì)自動(dòng)下載依賴包，而golang.org/x/…之類的包需要翻墻，可以添加GOPROXY環(huán)境變量設(shè)置代理:

export GOPROXY=https://goproxy.io

此時(shí)，go.mod文件會(huì)自動(dòng)更新，它包含項(xiàng)目所需的依賴項(xiàng)和對(duì)應(yīng)版本號(hào)

$ cat go.mod module github.com/you/hello require rsc.io/quote v1.5.2

除了go.mod之外，go還維護(hù)一個(gè)名為go.sum的文件，其中包含特定模塊版本的預(yù)期哈希值：

cat go.sum golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c h1:qgOY6WgZOaTkIIMiVjBQcw93ERBE4m30iBm00nkL0i8= golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= rsc.io/quote v1.5.2 h1:w5fcysjrx7yqtD/aO+QwRjYZOKnaM9Uh2b40tElTs3Y= rsc.io/quote v1.5.2/go.mod h1:LzX7hefJvL54yjefDEDHNONDjII0t9xZLPXsUe+TKr0= rsc.io/sampler v1.3.0 h1:7uVkIFmeBqHfdjD+gZwtXXI+RODJ2Wc4O7MPEh/QiW4= rsc.io/sampler v1.3.0/go.mod h1:T1hPZKmBbMNahiBKFy5HrXp6adAjACjK9JXDnKaTXpA=

go使用go.sum文件確保這些模塊的未來(lái)下載與第一次下載相同，以此確保項(xiàng)目所依賴的模塊不會(huì)出現(xiàn)意外更改。
go.mod和go.sum都應(yīng)檢入版本控制。

日常WorkFlow

典型的日常工作流程可能是：

根據(jù)需要在.go代碼中添加import語(yǔ)句

標(biāo)準(zhǔn)命令（如go build或go test）會(huì)根據(jù)需要自動(dòng)添加新的依賴項(xiàng)（更新go.mod并下載新的依賴項(xiàng))

需要特定版本的時(shí)候，可以使用go get指定特定版本如go get foo@v1.2.3, go get foo@master, go get foo@e3702bed2，或者直接編輯go.mod文件

常用的命令:

go list -m all 查看項(xiàng)目中所有直接和間接依賴關(guān)系

go mod tidy 清除未使用的依賴項(xiàng),并添加其他所需依賴項(xiàng)

go mod vendor 將依賴復(fù)制到vendor目錄下