golang包管理解決之道——go modules初探

golang的包管理是一直是爲人詬病之處,從golang1.5引入的vendor機制,到準官方工具dep,目前爲止還沒一個簡便的解決方案。

不過現在go modules隨着golang1.11的發佈而和我們見面了,這是官方提倡的新的包管理,乃至項目管理機制,可以不再需要GOPATH的存在。

go modules的初始化

現在modules機制仍在早期階段,所以golang提供了一個環境變量“GO111MODULE”,默認值爲auto,如果當前目錄裏有go.mod文件,就使用go modules,否則使用舊的GOPATH和vendor機制,因爲在modules機制下go get只會下載go modules,這一行爲會在以後版本中成爲默認值,這裏我們保持auto即可,如果你想直接使用modules而不需要從GOPATH過度,那麼把“GO111MODULE”設置爲on。

modules和傳統的GOPATH不同,不需要包含例如src,bin這樣的子目錄,一個源代碼目錄甚至是空目錄都可以作爲module,只要其中包含有go.mod文件。

我們就用一個空目錄來創建我們的第一個module:

要初始化modules,需要使用如下命令(假設已經安裝配置好golang1.11):

go mod init [module name]

我們的module叫test,所以就是:

go mod init test

初始完成後會在目錄下生成一個go.mod文件,裏面的內容只有一行“module test”。

包管理

那麼我們怎麼進行包管理呢?別擔心,當我們使用go build,go test以及go list時,go會自動得更新go.mod文件,將依賴關係寫入其中。

如果你想手動處理依賴關係,那麼使用如下的命令:

go mod tidy

這條命令會自動更新依賴關係,並且將包下載放入cache。

下面我們使用chromedp的一個簡單example作爲實驗代碼main.go,看下go modules是如何處理包的依賴關係的。

我們手動運行go mod tidy:
在這裏插入圖片描述
查找並下載包
在這裏插入圖片描述
我們發現多了一個go.sum,我們看看它裏面是什麼內容:
在這裏插入圖片描述
沒錯,你已經猜到了,這是我們直接引用的package和它自身需要的以來的版本記錄,go modules就是根據這些去找到需要的packages的。

順帶一提,如果我們不做任何修改,默認會使用最新的包版本,如果包打過tag,那麼就會使用最新的那個tag對應的版本。

下面我們使用go build來編譯我們的代碼:

go build

值得注意的是,新增了一個編譯選項“-mod”,它有如下的可選值:

go build -mod=readonly

在這個模式下任何會導致依賴關係變動的情況都將導致build失敗,前面提到過build能查找並更新依賴關係,使用這個選項可以檢查依賴關係的變動。

go build -mod=vendor

意思是忽略cache裏的包,只使用vendor目錄裏的版本。

構建完成後目錄結構如下:
在這裏插入圖片描述
我們的代碼成功構建了,包管理都由go modules替我們完成了。

包的版本控制

包管理的另外一項重要功能就是包的版本控制。modules同樣可以做到。

在介紹版本控制之前,我們要先明確一點,如果上層目錄和下層目錄的go.mod裏有相同的package規則,那麼上層目錄的無條件覆蓋下層目錄,目的是爲了main module的構建不會被依賴的package所影響。

那麼我們看看go.mod長什麼樣:

module test

require github.com/chromedp/chromedp v0.1.2

如果有多個依賴,可以是這樣的:

module github.com/chromedp/chromedp

require (
	github.com/chromedp/cdproto v0.0.0-20180713053126-e314dc107013
	github.com/disintegration/imaging v1.4.2
	github.com/gorilla/websocket v1.2.0
	github.com/knq/sysutil v0.0.0-20180306023629-0218e141a794
	github.com/mailru/easyjson v0.0.0-20180606163543-3fdea8d05856
	golang.org/x/image v0.0.0-20180708004352-c73c2afc3b81
)

前面部分是包的名字,也就是import時需要寫的部分,而空格之後的是版本號,版本號遵循如下規律:

vX.Y.Z-pre.0.yyyymmddhhmmss-abcdefabcdef
vX.0.0-yyyymmddhhmmss-abcdefabcdef
vX.Y.(Z+1)-0.yyyymmddhhmmss-abcdefabcdef
vX.Y.Z

也就是版本號+時間戳+hash,我們自己指定版本時只需要制定版本號即可,沒有版本tag的則需要找到對應commit的時間和hash值。

默認使用最新版本的package。

現在我們要修改依賴關係了,我們想使用chromedp 的v0.1.0版本,怎麼辦呢?

只需要如下命令:

go mod edit -require="github.com/chromedp/[email protected]"

@後面加上你需要的版本號。go.mod已經修改了:

module test

require github.com/chromedp/chromedp v0.1.0

我們還需要讓go modules更新依賴關係,這裏我們手動go mod tidy之後:
在這裏插入圖片描述

注意顏色較深的那兩行,我們已經切換到了v0.1.0版本了。
go modules是一個很大的主題,以後我還將進一步介紹它。
因爲go1.11剛發佈不久,這篇文件作爲探路,必定會有錯誤和疏漏,歡迎大家指正!
原文鏈接:https://www.cnblogs.com/apocelipes/p/9534885.html

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章