govendor包管理工具的使用

1.govendor简介

golang工程的依赖包经常使用go get命令来获取，例如：go get github.com/kardianos/govendor ，会将依赖包下载到GOPATH的路径下。

常用的依赖包管理工具有godep，govendor等，在Golang1.5之后，Go提供了GO15VENDOREXPERIMENT 环境变量(Go 1.6版本默认开启该环境变量)，用于将go build时的应用路径搜索调整成为 当前项目目录/vendor 目录方式。通过这种形式，我们可以实现类似于 godep 方式的项目依赖管理。

2.安装与使用

2.1. 安装

go get -u -v github.com/kardianos/govendor

2.2. 使用

进入到项目目录

cd /home/gopath/src/app

初始化vendor目录

govendor init

查看vendor目录

[root@CC54425A vendor]# ls

vendor.json

将GOPATH中本工程使用到的依赖包自动移动到vendor目录中

说明：如果本地GOPATH没有依赖包，先go get相应的依赖包

govendor add +external

或使用缩写： govendor add +e

现在看vendor.json 已经有依耐了

Go 1.6以上版本默认开启 GO15VENDOREXPERIMENT 环境变量，可忽略该步骤。

通过设置环境变量 GO15VENDOREXPERIMENT=1 使用vendor文件夹构建文件。

可以选择 export GO15VENDOREXPERIMENT=1 或 GO15VENDOREXPERIMENT=1 go build 执行编译

export GO15VENDOREXPERIMENT=1

2.3. 说明

govendor只是用来管理项目的依赖包，如果GOPATH中本身没有项目的依赖包，则需要通过go get先下载到GOPATH中，再通过govendor add +external拷贝到vendor目录中。Go 1.6以上版本默认开启GO15VENDOREXPERIMENT环境变量。

2.4 git版本管理

和pakeage.json同样, 我们需要将这个vendor.json添加到GIT, 但忽略vendor下的其他文件.

.gitignore

/vendor/*

!/vendor/vendor.json

2.5 拉取依赖到vendor

其他人可以使用vendor.json重新安装依赖包到vendor

govendor sync

2.6 使用vendor

注意vendor所在的目录一定要在第一个GOPAHT下

The project must be within a $GOPATH/src.

If using go1.5, ensure you set GO15VENDOREXPERIMENT=1.

2.7 Sub-commands

init    创建 vendor 文件夹和 vendor.json 文件

list    列出已经存在的依赖包

add      从 $GOPATH 中添加依赖包，会加到 vendor.json

update  从 $GOPATH 升级依赖包

remove  从 vendor 文件夹删除依赖

status  列出本地丢失的、过期的和修改的package

fetch  从远端库增加新的，或者更新 vendor 文件中的依赖包

sync    Pull packages into vendor folder from remote repository with revisions

migrate  Move packages from a legacy tool to the vendor folder with metadata.

get    类似 go get，但是会把依赖包拷贝到 vendor 目录

license  List discovered licenses for the given status or import paths.

shell    Run a "shell" to make multiple sub-commands more efficient for large projects.