主頁 > 知識庫 > 詳解Go module的介紹及使用

詳解Go module的介紹及使用

熱門標簽:谷歌美發(fā)店地圖標注 地圖區(qū)域圖標注后導出 赤峰電銷 400開頭電話怎樣申請 官渡電銷外呼管理系統(tǒng)怎么收費 江蘇呼叫中心外呼系統(tǒng)有效果嗎 貴州電話智能外呼系統(tǒng) 杭州人工智能電銷機器人費用 利用地圖標注位置

Go1.1.1版本發(fā)布(2018-08-24發(fā)布)已經(jīng)過去幾天,從官方的博客中看到,有兩個比較突出的特色,一個就是今天講的module,模塊概念。目前該功能還在試驗階段,有些地方還需要不斷的進行完善。在官方正式宣布之前,打算不斷修正這種支持。到時候就可以移除對GOPATHgo get命令的支持。
如果你想現(xiàn)在想就試試這個新功能module,需要你將你的代碼倉庫放到GOPATH/src目錄之外。然后在那個目錄下創(chuàng)建一個go.mod文件,從文件樹中運行go命令。

主要概念介紹

module是一個相關(guān)Go包的集合,它是源代碼更替和版本控制的單元。模塊由源文件形成的go.mod文件的根目錄定義,包含go.mod文件的目錄也被稱為模塊根。moudles取代舊的的基于GOPATH方法來指定在工程中使用哪些源文件或?qū)氚?。模塊路徑是導入包的路徑前綴,go.mod文件定義模塊路徑,并且列出了在項目構(gòu)建過程中使用的特定版本。

go.mod文件

go.mod文件定義module路徑以及列出其他需要在build時引入的模塊的特定的版本。例如下面的例子中,go.mod聲明example.com/m路徑時module的根目錄,同時也聲明了module依賴特定版本的golang.org/x/textgopkg.in/yaml.v2。

module example.com/m

require (
  golang.org/x/text v0.3.0
  gopkg.in/yaml.v2 v2.1.0
)

go.mod文件還可以指定要替換和排除的版本,命令行會自動根據(jù)go.mod文件來維護需求聲明中的版本。如果想獲取更多的有關(guān)go.mod文件的介紹,可以使用命令go help go.mod。
go.mod文件用//注釋,而不用/**/。文件的每行都有一條指令,由一個動作加上參數(shù)組成。例如:

module my/thing
require other/thing 	v1.0.2
require new/thing 		v2.3.4
exclude old/thing 		v1.2.3
replace bad/thing 		v1.4.5 	=> good/thing v1.4.5

上面三個動詞require、excludereplace分別表示:項目需要的依賴包及版本、排除某些包的特別版本、取代當前項目中的某些依賴包。
相同動作的命令可以放到一個動詞+括號組成的結(jié)構(gòu)中,例如:

require (
  new/thing v2.3.4
  old/thing v1.2.3
)

其他命令的支持

舊的版本,構(gòu)建編譯命令go build中的參數(shù)沒有-mod參數(shù),最新的版本現(xiàn)在多了這個,用來對go.mod文件進行更新或其他使用控制。形式如:go build -mod [mode],其中mode有以下幾種取值:readonly,release,vendor。當執(zhí)行go build -mod=vendor的時候,會在生成可執(zhí)行文件的同時將項目的依賴包放到主模塊的vendor目錄下。
go get -m [packages]會將下載的依賴包放到GOPATH/pkg/mod目錄下,并且將依賴寫入到go.mod文件。go get -u=patch會更新主模塊下的所有依賴包。
如果遇到不熟悉的導入包,任何可以查找包含該引入包模塊的go命令,都會自動將該模塊的最新版本添加到go.mod文件中。同時也會添加缺失的模塊,以及刪除無用的module。例如:go build, go test或者go list命令。另外,有一個專門的命令go mod tidy,用來查看和添加缺失的module需求聲明以及移除不必要的。
go.mod文件是可讀,也是可編輯的。go命令行會自動更新go.mod文件來維持一個標準格式以及精確的引入聲明。

Go mod命令

Go mod提供了一系列操作modules的命令,記住,所有的go命令中現(xiàn)在已經(jīng)內(nèi)置了對module的支持,而不僅僅是go mod命令。例如使用go get時,會經(jīng)常自動在后臺添加、移除、升級、降級依賴包版本。
命令語法:go mod command> [arguments]Go mod提供的命令有下面幾個,對于比較常用的命令進行詳細說明。

download        //下載模塊到本地緩存,具體可以通過命令go env查看,其中環(huán)境變量GOCACHE就是緩存的地址,如果該文件夾的內(nèi)容太大,可以通過命令go clean -cache
edit          //從工具或腳本中編輯go.mod文件
graph          //打印模塊需求圖
init          //在當前目錄下初始化新的模塊
tidy          //添加缺失的模塊以及移除無用的模塊
verify         //驗證依賴項是否達到預期的目的
why           //解釋為什么需要包或模塊

go mod download
用法:go mod download [-dir] [-json] [modules]。使用此命令來下載指定的模塊,模塊的格式可以根據(jù)主模塊依賴的形式或者path@version形式指定。如果沒有指定參數(shù),此命令會將主模塊下的所有依賴下載下來。
go mod download命令非常有用,主要用來預填充本地緩存或者計算Go模塊代理的回答。默認情況下,下載錯誤會輸出到標準輸出,正常情況下沒有任何輸出。-json參數(shù)會以JSON的格式打印下載的模塊對象,對應的Go對象結(jié)構(gòu)是這樣。

type Module struct {
  Path    string   //module path
  Version   string   //module version
  Error    string   //error loading module
  Info    string   //absolute path to cached .info file
  GoMod    string   //absolute path to cached .mod file
  Zip     string   //absolute path to cached .zip file
  Dir     string   //absolute path to cached source root directory
  Sum     string   //checksum for path, version (as in go.sum)
  GoModSum  string   //checksum for go.mod (as in go.sum)
}

go mod init
用法:go mod init [module]。此命令會在當前目錄中初始化和創(chuàng)建一個新的go.mod文件,當然你也可以手動創(chuàng)建一個go.mod文件,然后包含一些module聲明,這樣就比較麻煩。go mod init命令可以幫助我們自動創(chuàng)建,例如:

go mod init example.com/m

使用這條命令時,go.mod文件必須提前不能存在。初始化會根據(jù)引入包聲明來推測模塊的路徑或者如果你工程中之前已經(jīng)存在一些依賴包管理工具,例如godep,glide或者dep。那么go mod init同樣也會根據(jù)依賴包管理配置文件來推斷。
go mod tidy
默認情況下,Go不會移除go.mod文件中的無用依賴。所以當你的依賴中有些使用不到了,可以使用go mod tidy命令來清除它。
用法:go mod tidy [-v]它會添加缺失的模塊以及移除不需要的模塊。執(zhí)行后會生成go.sum文件(模塊下載條目)。添加參數(shù)-v,例如go mod tidy -v可以將執(zhí)行的信息,即移除的模塊打印到標準輸出。
go mod vendor
用法:go mod vendor [-v],此命令會將build階段需要的所有依賴包放到主模塊所在的vendor目錄中,并且測試所有主模塊的包。同理go mod vendor -v會將添加到vendor中的模塊打印到標準輸出。
go mod verify
用法:go mod verify。此命令會檢查當前模塊的依賴是否已經(jīng)存儲在本地下載的源代碼緩存中,以及檢查自從下載下來是否有修改。如果所有的模塊都沒有修改,那么會打印all modules verified,否則會打印變化的內(nèi)容。

虛擬版本號

go.mod文件和go命令通常使用語義版本作為描述模塊版本的標準形式,這樣可以比較不同版本的先后順序。例如模塊的版本是v1.2.3,那么通過重新對版本號進行標簽處理,得到該版本的虛擬版本。形式如:v0.0.0-yyyymmddhhmmss-abcdefabcdef。其中時間是提交時的UTC時間,最后的后綴是提交的哈希值前綴。時間部分確保兩個虛擬版本號可以進行比較,以確定兩者順序。
下面有三種形式的虛擬版本號:

  • vX.0.0-yyyymmddhhmmss-abcdefabcdef,這種情況適合用在在目標版本提交之前 ,沒有更早的的版本。(這種形式本來是唯一的形式,所以一些老的go.mod文件使用這種形式)
  • vX.Y.Z-pre.0.yyyymmddhhmmss-abcdefabcdef,這種情況被用在當目標版本提交之前的最新版本提交是vX.Y.Z-pre
  • vX.Y.(Z+1)-0.yyyymmddhhmmss-abcdefabcdef,同理,這種情況是當目標版本提交之前的最新版本是vX.Y.Z

虛擬版本的生成不需要你去手動操作,go命令會將接收的commit哈希值自動轉(zhuǎn)化為虛擬版本號。

環(huán)境變量——GO111MODULE

Go 1.11中module支持臨時環(huán)境變量——GO111MODULE,它可以設置以下三個值:off,on或者auto(默認)。

  1. 如果GO111MODULE=off,那么go命令行將不會使用新的module功能,相反的,它將會在vendor目錄下和GOPATH目錄中查找依賴包。也把這種模式叫GOPATH模式。
  2. 如果GO111MODULE=on,那么go命令行就會使用modules功能,而不會訪問GOPATH。也把這種模式稱作module-aware模式,這種模式下,GOPATH不再在build時扮演導入的角色,但是盡管如此,它還是承擔著存儲下載依賴包的角色。它會將依賴包放在GOPATH/pkg/mod目錄下。
  3. 如果GO111MODULE=auto,這種模式是默認的模式,也就是說在你不設置的情況下,就是auto。這種情況下,go命令行會根據(jù)當前目錄來決定是否啟用module功能。只有當當前目錄在GOPATH/src目錄之外而且當前目錄包含go.mod文件或者其子目錄包含go.mod文件才會啟用。

具體使用步驟:

  • 首先將你的版本更新到最新的Go版本(>=1.11),如何更新版本可以自行百度。
  • 通過go命令行,進入到你當前的工程目錄下,在命令行設置臨時環(huán)境變量set GO111MODULE=on;
  • 執(zhí)行命令go mod init在當前目錄下生成一個go.mod文件,執(zhí)行這條命令時,當前目錄不能存在go.mod文件。
  • 如果之前生成過,要先刪除;如果你工程中存在一些不能確定版本的包,那么生成的go.mod文件可能就不完整,因此繼續(xù)執(zhí)行下面的命令;
  • 執(zhí)行go mod tidy命令,它會添加缺失的模塊以及移除不需要的模塊
  • 執(zhí)行后會生成go.sum文件(模塊下載條目)。添加參數(shù)-v,例如go mod tidy -v可以將執(zhí)行的信息,即刪除和添加的包打印到命令行;
  • 執(zhí)行命令go mod verify來檢查當前模塊的依賴是否全部下載下來,是否下載下來被修改過。如果所有的模塊都沒有被修改過,那么執(zhí)行這條命令之后,會打印all modules verified。
  • 執(zhí)行命令go mod vendor生成vendor文件夾,該文件夾下將會放置你go.mod文件描述的依賴包,文件夾下同時還有一個文件modules.txt,它是你整個工程的所有模塊。在執(zhí)行這條命令之前,如果你工程之前有vendor目錄,應該先進行刪除。同理go mod vendor -v會將添加到vendor中的模塊打印出來;

總結(jié)

到此這篇關(guān)于詳解Go module的介紹及使用的文章就介紹到這了,更多相關(guān)Go module使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!

您可能感興趣的文章:
  • 使用go module導入本地包的方法教程詳解
  • go module使用本地包的方法示例
  • Django重裝mysql后啟動報錯:No module named ‘MySQLdb’的解決方法
  • 使用Go module和GoLand初始化一個Go項目的方法

標簽:鷹潭 松原 宜春 河池 保定 武漢 黔西 泰安

巨人網(wǎng)絡通訊聲明:本文標題《詳解Go module的介紹及使用》,本文關(guān)鍵詞  詳解,module,的,介紹,及,使用,;如發(fā)現(xiàn)本文內(nèi)容存在版權(quán)問題,煩請?zhí)峁┫嚓P(guān)信息告之我們,我們將及時溝通與處理。本站內(nèi)容系統(tǒng)采集于網(wǎng)絡,涉及言論、版權(quán)與本站無關(guān)。
  • 相關(guān)文章
  • 下面列出與本文章《詳解Go module的介紹及使用》相關(guān)的同類信息!
  • 本頁收集關(guān)于詳解Go module的介紹及使用的相關(guān)信息資訊供網(wǎng)民參考!
  • 推薦文章