引入moudle的目的

引入moudle模塊，取代了老版本中依賴GOPATH來制定工程中使用哪些源文件或?qū)氚姆绞健?/p>

什么是moudle

屬于go包管理工具的一種，是相關(guān)go包的集合，源代碼更替和版本控制的單元。

如何開啟module功能

首先，需要申明的是1.11以上版本的所有g(shù)o命令已經(jīng)內(nèi)置了對module的支持，例如，使用go get時，也會自動在后臺添加、移除、升級、降級依賴庫版本。

使用module功能需要設(shè)置環(huán)境變量GO111MODULE。
export GO111MODLE=on

GO111MODULE的三個選項：

• GO111MODULE=off 使用GOPATH模式，即在GOPATH下查找依賴項；
• GO111MODULE=on 使用module模式；
• GO111MODULE=auto 默認(rèn)模式，會根據(jù)當(dāng)前存在的目錄來確定使用哪一種模式，只有當(dāng)目錄不在GOPATH/src目錄并且存在go.mod文件的時候會選用MODULE模式；

go.mod 文件

（備注：可以使用go help go.mod 命令了解更多關(guān)于go.mod的信息）

• 定義模塊路徑，并列出相關(guān)使用版本；
• 屬于line-oriented, 只能用 // 注釋；
• 包含指令：

module my/thing //root module
require other/thing v1.0.2 //項目需要依賴的包及版本
exclude old/thing v1.2.3 //需要排除的特殊版本
replace bad/thing v1.4.5 => good/thing v1.4.5 //需要代替的版本

相同命令可以省略命令,如下組織

require(

)

go mod命令

命令語法：go mod [arguments]。Go mod提供的命令有下面幾個，對于比較常用的命令進(jìn)行詳細(xì)說明。

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

go mod download

用法：go mod download [-dir] [-json] [modules]。使用此命令來下載指定的模塊，模塊的格式可以根據(jù)主模塊依賴的形式或者path@version形式指定。如果沒有指定參數(shù)，此命令會將主模塊下的所有依賴下載下來。
go mod download命令非常有用，主要用來預(yù)填充本地緩存或者計算Go模塊代理的回答。默認(rèn)情況下，下載錯誤會輸出到標(biāo)準(zhǔn)輸出，正常情況下沒有任何輸出。-json參數(shù)會以JSON的格式打印下載的模塊對象，對應(yīng)的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]。此命令會在當(dāng)前目錄中初始化和創(chuàng)建一個新的go.mod文件，當(dāng)然你也可以手動創(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

默認(rèn)情況下，Go不會移除go.mod文件中的無用依賴。所以當(dāng)你的依賴中有些使用不到了，可以使用go mod tidy命令來清除它。
用法：go mod tidy [-v]它會添加缺失的模塊以及移除不需要的模塊。執(zhí)行后會生成go.sum文件(模塊下載條目)。添加參數(shù)-v，例如go mod tidy -v可以將執(zhí)行的信息，即移除的模塊打印到標(biāo)準(zhǔn)輸出。

go mod vendor

用法：go mod vendor [-v]，此命令會將build階段需要的所有依賴包放到主模塊所在的vendor目錄中，并且測試所有主模塊的包。同理go mod vendor -v會將添加到vendor中的模塊打印到標(biāo)準(zhǔn)輸出。

go mod verify

用法：go mod verify。此命令會檢查當(dāng)前模塊的依賴是否已經(jīng)存儲在本地下載的源代碼緩存中，以及檢查自從下載下來是否有修改。如果所有的模塊都沒有修改，那么會打印all modules verified，否則會打印變化的內(nèi)容。

虛擬版本號

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

vX.0.0-yyyymmddhhmmss-abcdefabcdef，
這種情況適合用在在目標(biāo)版本提交之前 ，沒有更早的的版本。（這種形式本來是唯一的形式，所以一些老的go.mod文件使用這種形式）

vX.Y.Z-pre.0.yyyymmddhhmmss-abcdefabcdef，
這種情況被用在當(dāng)目標(biāo)版本提交之前的最新版本提交是vX.Y.Z-pre

vX.Y.(Z+1)-0.yyyymmddhhmmss-abcdefabcdef,這種情況是當(dāng)目標(biāo)版本提交之前的最新版本是vX.Y.Z

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

總結(jié)

以上是生活随笔為你收集整理的Go 1.11 moudel 介绍的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。