vgo簡明教程

時間 2019-11-10

標籤 vgo 簡明教程简体版

原文原文鏈接

2018年8月25日更新：Go官方已將第三方庫管理工具定義爲模塊(modules)，這篇文章已過時，請你們閱讀新文章《Go模塊簡明教程》瞭解一下。

前言

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

相信你們都接觸過其它語言的第三方庫管理工具，好比Java的maven，PHP的composer，Python的pip，Node的npm等。vgo相似於這樣的功能，方便Go語言項目管理第三方庫。 github

Go語言官方之前一直沒有明確正式的包管理工具，所以致使包管理工具很是混亂，好比dep，glide，govendor，godep等。(雖然dep也是Go語言官方推出的，可是它最終會被放棄。)
vgo的推出，是Go語言社區的須要，將解決包管理工具混亂的問題。Go語言官方將使用這個依賴工具爲主，因此咱們有必要提早了解一下它的使用。 golang

(vgo即英文versioned go的縮寫) npm

Go官方說會在Go1.11中使用vgo，這個說明是在go wiki的《vgo user guide》一節中講到的。 json

Go1.11會在2018年8月推出，這個說明是在《Go 1.11 Release Notes》中講到的，此處連接須要跳牆。segmentfault

vendor目錄

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

安裝

說明：Go新版本中會直接使用vgo，但目前Go新版本尚未推出，爲了提早了解和使用，須要另外安裝。

源碼安裝

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

運行命令go get -u golang.org/x/vgo
二進制文件會自動生成在GOPATH的bin目錄下，若是你的GOPATH的bin目錄沒有在環境變量中配置，你須要將vgo二進制文件複製到你的環境變量路徑裏(方便任意目錄下命令行可直接輸入vgo來使用)。composer

沒法跳牆的方案

在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)。maven

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

如何使用？

一、項目目錄下的go.mod文件

go.mod文件像Java maven的pom.xml文件，PHP的composer.json文件，就是依賴的配置文件，放在項目的根目錄下。 ide

切記，go.mod文件至少要有 module 字段！！！
(提示：爲了這個，有些人還在main包使用註釋package main // import "xxx"語句來生成，其實你只要在go.mod文件指示這個項目的包路徑就能夠了，能夠不要註釋了。)

go.mod文件經常使用字段：
module 指示這個項目的包路徑(別人怎麼引用你的包名稱)
require 必須依賴
exclude 排除依賴
replace 替換依賴

二、經常使用命令

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目錄裏。