govendor 是 go 的一个比较好用包版本管理工具。主要用来保证 go 项目在协同开发或发版部署时，保证部署安装的依赖包版本对当前项目是稳定可用的。为什么要使用包版本管理工具java 的 maven，php 的 composer，nodejs 的 npm，python 的 requirement.txt，golang 的 govendor。例1：你的项目依赖一个github.com/foo 1.0.0的包，如果不使用包版本管理工具，他人在本地部署安装你的项目时，安装的包版本可能是最新的github.com/foo 2.0.0，如果两个版本存在兼容问题，就会出现crashed。例2：使用 go get 安装的项目依赖包的存放位置为 $GOPATH/src，即与你的项目路径同级，我们使用 git 时就没办法管理这些依赖包，不能也不应该将它们也提交到git仓库，如果提供一个包版本说明说，将说明书提交仓库，他人则根据此说明书安装依赖包。为解决此问题，govendor出现了，govendor会将项目依赖的包版本记录到your_proj/vendor/vendor.json中，后期将此文件提交至 git 仓库，则其他人 pull or clone 你的项目到本地后，即可使用 govendor 安装稳定的包依赖。govendor 工作流首先要部署好你的 go 环境，并将 $GOPATH/bin 路径加载到系统PATH中。我们将体验一遍如何使用govendor管理你的项目包版本，及如何安装他人的govendor管理的go项目（这点才是精华，很多博文都不提及，为什么版本管理，不就是为了能让程序在其他地方也能稳定运行嘛）。安装govendorgo get -u -v github.com/kardianos/govendor#运行 govendor 检测安装结果govendor如果能看到帮助提示信息，说明安装ok。项目初始化使用 govendor 初始化你的项目，将会在工程目录下自动创建 vendor 目录及 vendor/vendor.json 文件。如果是已有项目，也没关系，govendor允许你在项目开发的任何阶段去使用它，它总能将你的项目包版本管理起来。mkdir go_proj && cd go_proj# init projgovendor init#查看目录结构tree.└── vendor └── vendor.json1 directory, 1 file安装&管理包govendor get我们仍然可以通过 go get安装包到 $GOPATH/src下，但使用govendor get可以在安装包的同时将包纳入版本管理，而且会将包安装在$GOPATH/src/your_proj/vendor，更符合我们的要求。#安装在 $GOPATH/src 下go get github.com/go-sql-driver/mysql#安装在$GOPATH/src/your_proj/vendor下govendor get github.com/go-sql-driver/mysqlgovendor list & govendor addgovendor list可以帮助我们查看项目中引入的包的状态，即哪些是没有纳入版本管理的外部包，哪些是纳入版本管理的包，哪些是标准包，哪些是本地包等。govendor listStatus Types +local (l) packages in your project 你自己在项目中定义的包 +external (e) referenced packages in GOPATH but not in current project 使用 go get 安装的项目外部包 +vendor (v) packages in the vendor folder 使用 govendor get 安装的纳入版本管理的包 +std (s) packages in the standard library 标准包 fmt/time/runtime 等 +excluded (x) external packages explicitly excluded from vendoring 排除的外部包 +unused (u) packages in the vendor folder, but unused 安装但没引用的包 +missing (m) referenced packages but not found 引用但没安装的包 缺失了 +program (p) package is a main package 你的项目主包,它总会同 l 一起出现 pl 这个很好理解吧 +outside +external +missing +all +all packagesgovendor add则是方便我们在任何时间将项目包纳入版本管理。比如我们前期一直使用或现在偶然使用go get安装了一个项目的依赖包，此包是不会被记录在vendor/vendor.json中的，即没有纳入版本管理，那该如何将其纳入呢？go add +external执行上方命令即可，这样项目依赖的包都纳入了版本管理。提交git仓库在提交源码至git仓库时，我们没有必要将依赖包源文件也一并提交至仓库，所以 .gitignore 的编排要加上如下规则：# vi .gitignorevendor/*!vendor/vendor.json即排除vendor下的除vendor/vendor.json外的所有文件（这些文件其实就是依赖包），将vendor/vendor.json提交至git仓库即可。安装/部署 govendor 项目当我们从git仓库下载好govendor管理的golang项目时，需要安装好项目的包依赖，才可以正常的运行程序，类似 composer install的作用，这里则是使用govendor sync。这里使用我的一个 govendor 管理的基于Gin的MVC简易框架给大家演示一下：cd $GOPATH/src && git clone git@github.com:sqrtcat/easy-gin.git && cd easy-gingovendor sync运行程序即可，简单！