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/gin@v1.2获取依赖包的指定版本
vgo mod -vendor将依赖包直接放在项目的vendor目录里

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

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

举例说明

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

参考资料

posted @ 2021-07-06 18:47  dreamw  阅读(216)  评论(0编辑  收藏  举报