在go modules裏使用go get進行包管理
上一篇文章裏我們介紹了go modules的初步使用,現在我們來更深入的了解一下如何使用go get在module中管理依賴。
module下的包管理
首先我們介紹過go mod edit修改go.mod,然而它有兩點缺陷:
- 首先是它的-require必須接受“package@version”這種形式,缺一不可,而且不能識別文檔規定的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 package@latest一樣
- 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 package@指定的version即可
那麽我們想要把chromedp改用最新版本就很簡單了:
go get github.com/chromedp/chromedp@master
現在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/gorm@v1.9
很遺憾,版本選擇是從大版本到小版本的順序,如果有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的資料還不完善,所以我也是對著文檔邊看邊做,難免會有疏漏和錯誤,歡迎大家指正!
在go modules裏使用go get進行包管理