關(guān)于go module的使用

在go1.11版本以后go modules成為了go官方的依賴管理方式,替換一起的Godep。使用go modules管理依賴后會在當(dāng)前的項目根目錄下生成go.mod和go.sum.

  • go.mod

    在其中記錄當(dāng)前的項目的所有依賴,文件格式如下:

    module go-demos
    
    go 1.13
    
    require github.com/x-mod/routine v1.2.7
    

    module go-demos
    
    go 1.13
    
    require (
          github.com/x-mod/routine v1.2.7
    )
    replace (  // 針對有些被墻不能下載 可以替換成其他依賴包
        golang.org/x/text v0.3.0 => github.com/golang/text v0.3.0
    )
    
  • go.sum

    在其中記錄每個依賴庫的版本和哈希值,文件格式如下:

    cloud.google.com/go v0.26.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw=
    github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU=
    github.com/client9/misspell v0.3.4/go.mod h1:qj6jICC3Q7zFZvVWo7KLAzC3yx5G7kyvSDkc90ppPyw=
    

一.啟用go modules

1.1 要求

(1)go版本 >= 1.11 (1.11才添加的)

(2)設(shè)置GO111MODULE環(huán)境變量設(shè)置:

? GO111MODULE用來開啟go module。其有三個值:off/on/auto; off關(guān)閉go module,on開啟go moudle,而auto則會根據(jù)當(dāng)前工程project目錄下是否有g(shù)o.mod文件來判斷是否使用modules功能。需要指出的無論go module處于哪種模式下,module功能都不會在GOPATH指定目錄下查找依賴文件,故而盡量設(shè)置代理GOPROXY變量來保證使用go module能夠確保依賴下載到。

? 還有一點需要指出的,使用go module時,盡量手動設(shè)置GO111MODULE全局環(huán)境變量值為off,主要是為了兼容以前未使用go module項目引入go module。

echo export GO111MODULE=off >> ~/.bash_profile
或
直接在文件中手動設(shè)定

go mod命令:詳情見go modules

download    下載依賴的module到本地cache
edit        編輯go.mod文件
graph       打印模塊依賴圖
init        在當(dāng)前文件夾下初始化一個新的module, 創(chuàng)建go.mod文件
tidy        增加丟失的module,去掉未使用的module
vendor      將依賴復(fù)制到vendor下
verify      校驗依賴
why         解釋為什么需要依賴
二. 使用module

2.1 新建項目

$ export GO111MODULE=on
$ go mod init project目錄(TestPro/github.com/XXX/TestPro)
......
$ go build //此時會將當(dāng)前項目引用的依賴包括其依賴的依賴也會添加到go.mod中

2.2 已存在項目

$ export GO111MODULE=on
$ go mod init // 在當(dāng)前project根目錄下創(chuàng)建一個空的go.mod
$ go get 依賴  // 將當(dāng)前項目中使用的依賴添加到go.mod中

需注意一點:go.mod是需要提交到代碼倉庫中的,而go.sum文件并不需要。

三. 打包

需要對前面已增加go module打包進(jìn)行發(fā)布,此時要將當(dāng)前項目需要的依賴下載到本地vendor目錄。

### 指定打包生成的目標(biāo)平臺
export GO111MODULE="on" # 開啟go module
export GOPROXY="https://mirrors.aliyun.com/goproxy/"#指定GOPROXY下載對應(yīng)的依賴也可用replace替換
export CGO_ENABLED="0"  # 使用cgo
export GOOS="linux"     # 目標(biāo)平臺
export GOARCH=amd64     # 系統(tǒng)架構(gòu)

go mod vendor  # 依賴下載到vendor目錄
go build       # 構(gòu)建
或
go build -ldflags "-s -w" -a -installsuffix cgo -o audit-webhook .

至此基本的go module已完成。

還有一些需要注意點:go module默認(rèn)是不會在GOPATH下查找依賴文件的,其會在GOPATH/pkg/mod下查找有沒有存在對應(yīng)的依賴,沒有則進(jìn)行下載。也可以使用go mod download下載所需的依賴,默認(rèn)會將依賴下載到GOPATH/pkg/mod下,這樣其他的module就可以使用已緩存在本地的依賴。

四. 引用

官方modules

使用modules

跳出Go module的泥潭

Go Modules詳解

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,565評論 6 539
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 99,115評論 3 423
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,577評論 0 382
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經(jīng)常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,514評論 1 316
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點故事閱讀 72,234評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 55,621評論 1 326
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,641評論 3 444
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 42,822評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 49,380評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 41,128評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,319評論 1 371
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,879評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 44,548評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,970評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,229評論 1 291
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,048評論 3 397
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 48,285評論 2 376