vgo简明教程

2018年8月25日更新：Go官方已将第三方库管理工具定义为模块(modules)，这篇文章已过期，请大家阅读新文章《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的缩写)

Go官方说会在Go1.11中使用vgo，这个说明是在go wiki的《vgo user guide》一节中讲到的。

Go1.11会在2018年8月推出，这个说明是在《Go 1.11 Release Notes》中讲到的，此处链接需要跳墙。

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/[email protected]获取依赖包的指定版本
vgo mod -vendor将依赖包直接放在项目的vendor目录里

更多命令请使用vgo help来查看。

获取的依赖包数据会缓存到GOPATH路径下的src/mod目录里。

举例说明

这里有一些vgo使用的例子：https://github.com/wuyumin/vg...
比如最简单的hello目录，你在该目录下运行vgo build可以直接生成二进制文件。你可以查看一下go.mod文件的简单写法。

参考资料

• vgo user guide(英文)：https://github.com/golang/go/...
• vgo进入Go语言仓库的commit：https://github.com/golang/go/...
• vgo仓库：https://github.com/golang/vgo
• vgo wiki(英文)：https://github.com/golang/go/...
• vgo设计理念(英文，有墙)：https://research.swtch.com/vgo
• Go 1.11 Release Notes(英文，有墙)：https://tip.golang.org/doc/go...