使用vendor管理Golang項目依賴

這是一個建立於 的文章，其中的資訊可能已經有所發展或是發生改變。

http://www.tuicool.com/articles/NjMzIbJ

我們在項目中除了大量的使用Python外，也大量的使用了Golang構建高效基礎運行服務。在使用Golang過程中，我們發現Golang程式缺少依賴庫版本功能是一個非常令人頭大的問題：某些依賴在某個commit之後發生了API變更之後，如果不修改代碼很難相容，然而開發人員之間很有可能因為參與的時間不同，導致執行 go get 命令擷取的版本不同，而導致在不同電腦上出現編譯不通過問題。同時，在多個程式中，如果使用的commit版本不同，也可能會導致程式編譯過程中出現不同的問題。

在之前，我們解決這個問題有兩個方案，一種是拆解 go get 命令的執行，首先建立對應依賴目錄，利用git命令切換至指定的commit，然後執行 go install 命令。另外一種比較省事的方法是使用 godep 工具，這裡就不做過多介紹了，具體可以參考文檔或者搜尋中文教程。

在Golang1.5之後，Go提供了 GO15VENDOREXPERIMENT 環境變數，用於將go build時的應用路徑搜尋調整成為 當前項目目錄/vendor 目錄方式。通過這種形式，我們可以實作類別似於 godep 方式的項目依賴管理。不過起碼在程式編譯過程中，再也無需在其他端部署一個 godep 工具。

在使用之前，需要安裝一個協助工具輔助（如果Golang自改一個就好了）： go get -u -v github.com/kardianos/govendor 。

下面，我們用一個例子來說明。首先有一個名為 vendorproj 的項目。假如只有一個檔案：

package mainimport (    "github.com/yeeuu/echoic")func main() {    e := echoic.New()    e.SetDebug(true)    e.Run("127.0.0.1:4321")}

執行一下命令就可以產生vendor檔案夾：

$ govendor init$ lsmain.go    vendor$ cd vendor/$ lsvendor.json

這個 vendor.json 會類似 godep 工具中的描述檔案版本的功能。接下來，需要執行命令將當前應用必須的檔案包含進來

$ govendor add +external

如果需要更新或移除，可以參考一下工具的具體文檔使用 update 或者 remove 命令即可。這樣會在vendor目錄下將必須的編譯檔案移入進來（注意：測試所需依賴並不包含，依賴項目的測試檔案也不會包含）。

$ lsgithub.com  golang.org  vendor.json$ cat vendor.json{    "comment": "",    "ignore": "test",    "package": [        {            "path": "github.com/yeeuu/echoic",            "revision": "a7d6994f92e2dc60cff071ae38b204fbd4bd2a3f",            "revisionTime": "2015-12-18T11:14:29+08:00"        },        {            "path": "golang.org/x/net/context",            "revision": "1d9fd3b8333e891c0e7353e1adcfe8a612573033",            "revisionTime": "2015-11-13T15:40:13-08:00"        }    ]}$ cd github.com/yeeuu/echoic$ lsLICENSE     context.go  group.go    router.goREADME.md   echoic.go   response.go

通過設定環境變數 GO15VENDOREXPERIMENT=1 使用vendor檔案夾構建檔案。可以選擇 export GO15VENDOREXPERIMENT=1 或者乾脆 GO15VENDOREXPERIMENT=1 go build 執行編譯。

通過這種方式就可以保證程式能夠實作類別似Python中Virtualenv的模式，實現不同程式使用不同版本依賴的目的。