1. 程式人生 > >在go modules裡使用go get進行包管理

在go modules裡使用go get進行包管理

上一篇文章裡我們介紹了go modules的初步使用,現在我們來更深入的瞭解一下如何使用go get在module中管理依賴。

module下的包管理

首先我們介紹過go mod edit修改go.mod,然而它有兩點缺陷:

  • 首先是它的-require必須接受“[email protected]”這種形式,缺一不可,而且不能識別文件規定的master和latest標誌。
  • 其次是edit只適合用於修改依賴版本,給package改名,遮蔽特定的package這三個功能,不適用於新增依賴。

好訊息是go get現在有了在modules中新增/修改/更新package的能力。

想要完整體驗go modules,我們需要選擇一個GOPATH以外的目錄,並且設定GO11MODULE=on,這樣使用go get時只會影響當前的main module,不會汙染GOPATH。

這次我選用自己做著玩的玩具專案演示在沒有進行包管理的專案中使用go modules。(關於vendor的遷移,可以使用go mod vendor -v,詳細介紹以後會有)。

我們將專案clone到非GOPATH的路徑下,然後使用

go mod init [project name]

初始化module。初始化後的目錄:
在這裡插入圖片描述
這時go.mod還是空的,我們知道go build會更新go.mod,所以我們先go build
在這裡插入圖片描述
預設會使用go get獲得latest的package,現在go.mod已經被更新了,專案也成功被編譯,這是go.mod:

module schanclient

require (
    github.com/PuerkitoBio/goquery v1.4.1
    github.com/andybalholm/cascadia v1.0.0 // indirect
    github.com/chromedp/chromedp v0.1.2
    golang.org/x/net v0.0.0-20180826012351-8a410e7b638d // indirect
)

indirect的意思是指這個package被子module/package依賴了,但是main module並沒有直接import使用,也就是所謂的間接引用。

通常,go.mod使用預設行為就可以很好地完成包管理,不過生活中總是有些例外。

我們看到chromedp使用了0.1.2版本,這是三個月前的版本了,最新的commit在上個月,go mod edit需要明確指定版本號或者commit的時間+checksum,顯然這很麻煩,不是我們希望的。

那麼我們要如何才能使用最新的版本而不是最新的tags呢?

又或者我們不想要最新的版本,需要某個特定版本的package呢?

這就是版本選擇的內容了。

go get的新特性——版本選擇

以前有過gopkg.in+go get這種解決方案,而新的go get所支援的版本選擇則是這一方案的進一步擴充套件,看幾條規則:

  • go get會自動下載並安裝package,然後更新到go.mod中
  • 可以使用go get package[@version]來安裝指定版本的package,不指定version時預設行為和go get [email protected]一樣
  • version可以是vx.y.z這種形式或者直接使用commit的checksum,也可以是master或者latest
  • 當version是latest時,也就是預設行為,對於有tags的package,會選取最新的tag,對於沒有tags的package,則選取最新的commit
  • 當version是master時,不管package有沒有打tag,都會選擇master分支的最新commit
  • 可以在version前使用>,>=,<,<=,表示選取的版本不得超過/低於version,在這個範圍內的符合latest條件的版本
  • go get -u可以更新package到latest版本
  • go get -u=patch將只更新小版本,例如從v1.2.4到v1.2.5
  • 當想要修改package的版本時,只需要go get [email protected]指定的version即可

那麼我們想要把chromedp改用最新版本就很簡單了:

go get github.com/chromedp/[email protected]

現在go.mod裡已經將chromedp更新了:

module schanclient

require (
	github.com/PuerkitoBio/goquery v1.4.1
	github.com/andybalholm/cascadia v1.0.0 // indirect
	github.com/chromedp/chromedp v0.1.3-0.20180717231922-bf52fed0d3e6
	golang.org/x/net v0.0.0-20180826012351-8a410e7b638d // indirect
)

如果我們現在想要新增額外的package呢?

直接使用go get就可以了,比如我現在想用gorm往資料庫存資料:

go get github.com/jinzhu/gorm

更新後的go.mod

module schanclient

require (
	github.com/PuerkitoBio/goquery v1.4.1
	github.com/andybalholm/cascadia v1.0.0 // indirect
	github.com/chromedp/chromedp v0.1.3-0.20180717231922-bf52fed0d3e6
	github.com/jinzhu/gorm v1.9.1 // indirect
	github.com/jinzhu/inflection v0.0.0-20180308033659-04140366298a // indirect
	golang.org/x/net v0.0.0-20180826012351-8a410e7b638d // indirect
)

我們看到latest版本的gorm已經被添加了,當然因為我們在main module裡沒有import使用它,所以是indirect的。

如果我們想用v1.9的gorm:

go get github.com/jinzhu/[email protected]

很遺憾,版本選擇是從大版本到小版本的順序,如果有v1.9和v1.9.1,那麼當你指定v1.9時會自動選取小版本號最高的版本,除非除了v1.9之外沒有其他的v1.9.z的tag存在,在這裡就是v1.9.1。

還有一點值得一提,go build和go test只會將go.mod中沒有的package新增進去,不會覆蓋或者改變go get引入的規則,所以不用擔心他們會衝突。

是不是覺得和venv+pip很像,沒錯,這說明go的包管理工具也逐漸步入現代化了。

至於遮蔽package,刪除package以及為package改名(比如golang.org/x/…的訪問不了的package),這些是go mod edit的功能,具體的請檢視go help mod edit。

因為go modules的資料還不完善,所以我也是對著文件邊看邊做,難免會有疏漏和錯誤,歡迎大家指正!