19. 一文搞懂 Go Modules 前世此生及入門使用

時間 2020-05-26

標籤一文 modules 前世此生入門使用简体版

原文原文鏈接

Hi，你們好。html

我是明哥，在本身學習 Golang 的這段時間裏，我寫了詳細的學習筆記放在個人我的微信公衆號《Go編程時光》，對於 Go 語言，我也算是個初學者，所以寫的東西應該會比較適合剛接觸的同窗，若是你也是剛學習 Go 語言，不防關注一下，一塊兒學習，一塊兒成長。linux

在線博客：golang.iswbm.com Github：github.com/iswbm/GolangCodingTimeandroid

在之前，Go 語言的的包依賴管理一直都被你們所詬病，Go官方也在一直在努力爲開發者提供更方便易用的包管理方案，從最初的 GOPATH 到 GO VENDOR，再到最新的 GO Modules，雖然走了很多的彎路，但最終仍是拿出了 Go Modules 這樣像樣的解決方案。git

目前最主流的包依賴管理方式是使用官方推薦的 Go Modules ，這不前段時間 Go 1.14 版本發佈，官方正式放話，強烈推薦你使用 Go Modules，而且有自信能夠用於生產中。github

本文會大篇幅的講解 Go Modules 的使用，可是在那以前，我仍然會簡要介紹一下前兩個解決方案 GOPATH 和 go vendor 究竟是怎麼回事？我認爲這是有必要的，由於只有瞭解它的發展歷程，才能知道 Go Modules 的到來是有多麼的不容易，多麼的意義非凡。golang

1. 最古老的 GOPATH

GOPATH 應該不少人都很眼熟了，以前在配置環境的時候，都配置過吧？算法

你能夠將其理解爲工做目錄，在這個工做目錄下，一般有以下的目錄結構shell

每一個目錄存放的文件，都不相同編程

bin：存放編譯後生成的二進制可執行文件
pkg：存放編譯後生成的 .a 文件
src：存放項目的源代碼，能夠是你本身寫的代碼，也能夠是你 go get 下載的包

將你的包或者別人的包所有放在 $GOPATH/src 目錄下進行管理的方式，咱們稱之爲 GOPATH 模式。json

在這個模式下，使用 go install 時，生成的可執行文件會放在 $GOPATH/bin 下

若是你安裝的是一個庫，則會生成 .a 文件到 $GOPATH/pkg 下對應的平臺目錄中（由 GOOS 和 GOARCH 組合而成），生成 .a 爲後綴的文件。

GOOS，表示的是目標操做系統，有 darwin（Mac），linux，windows，android，netbsd，openbsd，solaris，plan9 等

而 GOARCH，表示目標架構，常見的有 arm，amd64 等

這兩個都是 go env 裏的變量，你能夠經過 go env 變量名 進行查看

至此，你可能不會以爲上面的方案會產生什麼樣的問題，直到你開始真正使用 GOPATH 去開發程序，就不得不開始面臨各類各樣的問題，其中最嚴重的就是版本管理問題，由於 GOPATH 根本沒有版本的概念。

如下幾點是你使用 GOPATH 必定會碰到的問題：

你沒法在你的項目中，使用指定版本的包，由於不一樣版本的包的導入方法也都同樣
其餘人運行你的開發的程序時，沒法保證他下載的包版本是你所指望的版本，當對方使用了其餘版本，有可能致使程序沒法正常運行
在本地，一個包只能保留一個版本，意味着你在本地開發的全部項目，都得用同一個版本的包，這幾乎是不可能的。

2. go vendor 模式的過渡

爲了解決 GOPATH 方案下不一樣項目下沒法使用多個版本庫的問題，Go v1.5 開始支持 vendor 。

之前使用 GOPATH 的時候，全部的項目都共享一個 GOPATH，須要導入依賴的時候，都來這裏找，正所謂一山不容二虎，在 GOPATH 模式下只能有一個版本的第三方庫。

解決的思路就是，在每一個項目下都建立一個 vendor 目錄，每一個項目所需的依賴都只會下載到本身vendor目錄下，項目之間的依賴包互不影響。在編譯時，v1.5 的 Go 在你設置了開啓 GO15VENDOREXPERIMENT=1 （注：這個變量在 v1.6 版本默認爲1，可是在 v1.7 後，已去掉該環境變量，默認開啓 vendor 特性，無需你手動設置）後，會提高 vendor 目錄的依賴包搜索路徑的優先級（相較於 GOPATH）。

其搜索包的優先級順序，由高到低是這樣的

當前包下的 vendor 目錄
向上級目錄查找，直到找到 src 下的 vendor 目錄
在 GOROOT 目錄下查找
在 GOPATH 下面查找依賴包

雖然這個方案解決了一些問題，可是解決得並不完美。

若是多個項目用到了同一個包的同一個版本，這個包會存在於該機器上的不一樣目錄下，不只對磁盤空間是一種浪費，並且無法對第三方包進行集中式的管理（分散在各個角落）。
而且若是要分享開源你的項目，你須要將你的全部的依賴包悉數上傳，別人使用的時候，除了你的項目源碼外，還有全部的依賴包所有下載下來，才能保證別人使用的時候，不會由於版本問題致使項目不能如你預期那樣正常運行。

這些看似不是問題的問題，會給咱們的開發使用過程變得很是難受，雖然我是初學者，還未使用過 go vendor，但能有很明顯的預感，這個方案照樣會另我崩潰。

3. go mod 的橫空出世

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"複製代碼

4. go mod 依賴的管理

接下來，來演示一下 go modules 是如何來管理包依賴的。

go mod 再也不依靠 $GOPATH，使得它能夠脫離 GOPATH 來建立項目，因而咱們在家目錄下建立一個 go_test 的目錄，用來建立個人項目，詳細操做以下：

接下來，進入項目目錄，執行以下命令進行 go modules 的初始化

接下來很重要的一點，咱們要看看 go install 把下載的包安裝到哪裏了？

上面咱們觀察到，在使用 go modules 模式後，項目目錄下會多生成兩個文件也就是 go.mod 和 go.sum 。

這兩個文件是 go modules 的核心所在，這裏不得很差好介紹一下。

go.mod 文件

go.mod 的內容比較容易理解

第一行：模塊的引用路徑
第二行：項目使用的 go 版本
第三行：項目所需的直接依賴包及其版本

在實際應用上，你會看見更復雜的 go.mod 文件，好比下面這樣

module github.com/BingmingWong/module-test

go 1.14

require (
    example.com/apple v0.1.2
    example.com/banana v1.2.3
    example.com/banana/v2 v2.3.4
    example.com/pear // indirect
    example.com/strawberry // incompatible
)

exclude example.com/banana v1.2.4
replace（
    golang.org/x/crypto v0.0.0-20180820150726-614d502a4dac => github.com/golang/crypto v0.0.0-20180820150726-614d502a4dac
    golang.org/x/net v0.0.0-20180821023952-922f4815f713 => github.com/golang/net v0.0.0-20180826012351-8a410e7b638d
    golang.org/x/text v0.3.0 => github.com/golang/text v0.3.0
)複製代碼

主要是多出了兩個 flag：

exclude：忽略指定版本的依賴包
replace：因爲在國內訪問golang.org/x的各個包都須要fan牆，你能夠在go.mod中使用replace替換成github上對應的庫。

go.sum 文件

反觀 go.sum 文件，就比較複雜了，密密麻麻的。

能夠看到，內容雖然多，可是也不難理解

每一行都是由 模塊路徑，模塊版本，哈希檢驗值 組成，其中哈希檢驗值是用來保證當前緩存的模塊不會被篡改。hash 是以h1:開頭的字符串，表示生成checksum的算法是初版的hash算法（sha256）。

值得注意的是，爲何有的包只有一行

<module> <version>/go.mod <hash>複製代碼

而有的包卻有兩行呢

<module> <version> <hash>
<module> <version>/go.mod <hash>複製代碼

那些有兩行的包，區別就在於 hash 值不一行，一個是 h1:hash，一個是 go.mod h1:hash

而 h1:hash 和 go.mod h1:hash二者，要不就是同時存在，要不就是隻存在 go.mod h1:hash。那什麼狀況下會不存在 h1:hash 呢，就是當 Go 認爲確定用不到某個模塊版本的時候就會省略它的h1 hash，就會出現不存在 h1 hash，只存在 go.mod h1:hash 的狀況。[引用自 3]

go.mod 和 go.sum 是 go modules 版本管理的指導性文件，所以 go.mod 和 go.sum 文件都應該提交到你的 Git 倉庫中去，避免其餘人使用你寫項目時，從新生成的go.mod 和 go.sum 與你開發的基準版本的不一致。

5. go mod 命令的使用

go mod init：初始化go mod，生成go.mod文件，後可接參數指定 module 名，上面已經演示過。
go mod download：手動觸發下載依賴包到本地cache（默認爲$GOPATH/pkg/mod目錄）
go mod graph：打印項目的模塊依賴結構

go mod tidy ：添加缺乏的包，且刪除無用的包
go mod verify ：校驗模塊是否被篡改過
go mod why：查看爲何須要依賴
go mod vendor ：導出項目全部依賴到vendor下

go mod edit ：編輯go.mod文件，接 -fmt 參數格式化 go.mod 文件，接 -require=golang.org/x/text 添加依賴，接 -droprequire=golang.org/x/text 刪除依賴，詳情可參考 go help mod edit

go list -m -json all：以 json 的方式打印依賴詳情

如何給項目添加依賴（寫進 go.mod）呢？

有兩種方法：

你只要在項目中有 import，而後 go build 就會 go module 就會自動下載並添加。
本身手工使用 go get 下載安裝後，會自動寫入 go.mod 。

7. 總結寫在最後

若是讓我用一段話來評價 GOPATH 和 go vendor，我會說

GOPATH 作爲 Golang 的第一個包管理模式，只能保證你能用，但不保證好用，而 go vendor 解決了 GOPATH 忽視包版的本管理，保證好用，可是還不夠好用，直到 go mod 的推出後，才使 Golang 包的依賴管理有了一個能讓 Gopher 都統一比較滿意的方案，達到了能用且好用的標準。

若是是剛開始學習 Golang ，那麼 GOPATH 和 go vendor 能夠作適當瞭解，沒必要深刻研究，除非你要接手的項目因爲一些歷史緣由仍然在使用 go vender 械管理，除此以外，任何 Gopher 應該今後刻就投入 go modules 的懷抱。

以上是我在這幾天的學習總結，但願對還未入門階段的你，有所幫助。另外，本篇文章若有寫得不對的，請後臺批評指正，以避免誤導其餘朋友，很是感謝。