vgo簡明教程(Go語言依賴包管理工具)

前言

vgo是Go語言推出的第三方庫管理工具，即將在Go語言新版本中使用。

相信大家都接觸過其它語言的第三方庫管理工具，比如Java的maven，PHP的composer，Python的pip，Node的npm等。vgo類似於這樣的功能，方便Go語言專案管理第三方庫。

Go語言官方以前一直沒有明確正式的包管理工具，因此導致包管理工具非常混亂，比如dep，glide，govendor，godep等。(雖然dep也是Go語言官方推出的，但是它最終會被放棄。)
vgo的推出，是Go語言社區的需要，將解決包管理工具混亂的問題。Go語言官方將使用這個依賴工具為主，所以我們有必要提前瞭解一下它的使用。

(vgo即英文versioned go的縮寫)

vendor目錄

vendor目錄是Go1.5版本後添加的依賴包管理目錄。
依賴包目錄搜尋順序：vendor目錄 -> GOROOT -> GOPATH

安裝

說明：Go新版本中會直接使用vgo，但目前Go新版本還沒有推出，為了提前瞭解和使用，需要另外安裝。

源碼安裝

無牆或可跳牆的方案(快速)

運行命令go get -u golang.org/x/vgo
二進位檔案會自動產生在GOPATH的bin目錄下，如果你的GOPATH的bin目錄沒有在環境變數中配置，你需要將vgo二進位檔案複製到你的環境變數路徑裡(方便任意目錄下命令列可直接輸入vgo來使用)。

無法跳牆的方案

在GOPATH下的目錄層次src/golang.org/x(沒有哪個層次就建立哪個層次，因為vgo的包名是golang.org/x/vgo)，然後在x目錄下使用git複製vgo倉庫git clone github.com/golang/vgo，進入vgo目錄運行命令go build main.go，最後將產生的vgo二進位檔案複製到你的環境變數路徑裡(注意vgo二進位檔案的命名：Windows系統是vgo.exe，Mac或Linux是無尾碼的vgo)。

此方法也是一些國內被牆掉的Go包常用的技巧方法，順便提一下。

如何使用？

1、項目目錄下的go.mod檔案

go.mod檔案像Java maven的pom.xml檔案，PHP的composer.json檔案，就是依賴的設定檔。

切記，go.mod檔案至少要有 module 欄位！！！
(提示：為了這個，有些人還在main包使用注釋package main // import "xxx"語句來產生，其實你只要在go.mod檔案指示這個項目的包路徑就可以了，可以不要注釋了。)

go.mod檔案常用欄位：
module 指示這個項目的包路徑
require 必須依賴
exclude 排除依賴
replace 替換依賴

2、常用命令

vgo version查看vgo版本
vgo install安裝依賴
vgo build編譯項目
vgo run運行項目
vgo get github.com/gin-gonic/gin擷取依賴包的最新版本
vgo get github.com/gin-gonic/gin@v1.2擷取依賴包的指定版本
vgo mod -vendor將依賴包直接放在項目的vendor目錄裡

更多命令請使用vgo help來查看。

擷取的依賴包資料會緩衝到GOPATH路徑下的src/mod目錄裡。

舉例說明

這裡有一些vgo使用的例子：https://github.com/wuyumin/vg...
比如最簡單的hello目錄，你在該目錄下運行vgo build可以直接產生二進位檔案。你可以查看一下go.mod檔案的簡單寫法。

參考資料

• vgo進入Go語言倉庫的commit：https://github.com/golang/go/...
• vgo倉庫：https://github.com/golang/vgo
• vgo設計理念(英文，有牆)：https://research.swtch.com/vgo

修正建議

由於vgo目前是實驗階段，有些內容可能會有變化，我們會隨時關注及更新本文，也歡迎大家使用GitHub來協作。

GitHub上的原文連結：
https://github.com/wuyumin/vg...
歡迎在GitHub上star本項目進行協作或通過Issues提供修正建議。