您好,欢迎访问一九零五行业门户网

浅谈Go包依赖管理工具govendor

govendor 是一个基于 vendor 机制实现的 go 包依赖管理命令行工具。与原生 vendor 无侵入性融合,也支持从其他依赖管理工具迁移,可以很方便的实现同一个包在不同项目中不同版本、以及无相互侵入的开发和管理。vendor 特性最开始的时候,go 并没有提供较为妥当的包管理工具。从 1.5 版本开始提供了 vendor 特性,但需要手动设置环境变量 go15vendorexperiment=1。
在执行 go build 或 go run 命令时,会按照以下顺序去查找包:
当前包下的 vendor 目录向上级目录查找,直到找到 src 下的 vendor 目录在 goroot 目录下查找在 gopath 下面查找依赖包在发布 1.6 版本时,该环境变量的值已经默认设置为 1 了,该值可以使用 go env 命令查看。
在发布 1.7 版本时,已去掉该环境变量,默认开启 vendor 特性。
vendor 使用建议一个库工程(不包含 main 的 package)不应该在自己的版本控制中存储外部的包在 vendor 目录中,除非有特殊原因并且知道为什么要这么做。在一个应用中,(包含 main 的 package),建议只有一个 vendor 目录,且在代码库一级目录。
相关教程:go视频教程
govendor 简介govendor 是一个基于 vendor 目录机制的包管理工具。
支持从项目源码中分析出依赖的包,并从 $gopath 复制到项目的 vendor 目录下支持包的指定版本,并用 vendor/vendor.json 进行包和版本管理,这点与 php 的 composer 类似支持用 govendor add/update 命令从 $gopath 中复制依赖包如果忽略了 vendor/*/ 文件,可用 govendor sync 恢复依赖包可直接用 govendor fetch 添加或更新依赖包可用 govendor migrate 从其他 vendor 包管理工具中一键迁移到 govendor支持 linux,macos,windows,甚至现有所有操作系统支持 git、hg、svn,bzr(必须指定一个路径)govendor 使用要求:
项目必须在 $gopath/src 目录下如果 go 版本为 1.5,则必须手动设置环境变量 set go15vendorexperiment=1安装go get -u github.com/kardianos/govendor
为了方便快捷使用 govendor,建议将 $gopath/bin 添加到 path 中。linux/macos 如下设置:
export path="$gopath/bin:$path"
初始化在项目根目录下执行以下命令进行 vendor 初始化:
govendor init
项目根目录下即会自动生成 vendor 目录和 vendor.json 文件。此时 vendor.json 文件内容为:
{ "comment": "", "ignore": "test", "package": [], "rootpath": "govendor-example"}
常用命令将已被引用且在 $gopath 下的所有包复制到 vendor 目录govendor add +external
仅从 $gopath 中复制指定包govendor add gopkg.in/yaml.v2
列出代码中所有被引用到的包及其状态govendor list
e github.com/gin-contrib/sse e github.com/gin-gonic/gin e github.com/gin-gonic/gin/binding e github.com/gin-gonic/gin/internal/json e github.com/gin-gonic/gin/render e github.com/golang/protobuf/proto e github.com/mattn/go-isatty e github.com/ugorji/go/codec e gopkg.in/go-playground/validator.v8 e gopkg.in/yaml.v2pl govendor-example m github.com/json-iterator/go m golang.org/x/sys/unix
列出一个包被哪些包引用govendor list -v fmt
s fmt ├── e github.com/gin-contrib/sse ├── e github.com/gin-gonic/gin ├── e github.com/gin-gonic/gin/render ├── e github.com/golang/protobuf/proto ├── e github.com/ugorji/go/codec ├── e gopkg.in/go-playground/validator.v8 ├── e gopkg.in/yaml.v2 └── pl govendor-example
从远程仓库添加或更新某个包(不会在 $gopath 也存一份)govendor fetch golang.org/x/net/context
安装指定版本的包govendor fetch golang.org/x/net/context@a4bbce9fcae005b22ae5443f6af064d80a6f5a55govendor fetch golang.org/x/net/context@v1 # get latest v1.*.* tag or branch.govendor fetch golang.org/x/net/context@=v1 # get the tag or branch named "v1".
只格式化项目自身代码(vendor 目录下的不变动)govendor fmt +local
只构建编译项目内部的包govendor install +local
只测试项目内部的测试案例govendor test +local
构建所有 vendor 包govendor install +vendor,^program
拉取所有依赖的包到 vendor 目录(包括 $gopath 存在或不存在的包)govendor fetch +out
包已在 vendor 目录,但想从 $gopath 更新govendor update +vendor
已修改了 $gopath 里的某个包,现在想将已修改且未提交的包更新到 vendorgovendor update -uncommitted <updated-package-import-path>
fork 了某个包,但尚未合并,该如何引用到最新的代码包govendor fetch github.com/normal/pkg::github.com/myfork/pkg
此时将从 myfork 拉取代码,而不是 normal。
vendor.json 中记录了依赖包信息,该如何拉取更新govendor sync
govendor 子命令各子命令详细用法可通过 govendor command -h 或阅读 github.com/kardianos/govendor/context 查看源码包如何实现的。
子命令功能
init 创建 vendor 目录和 vendor.json 文件
list 列出&过滤依赖包及其状态
add 从 $gopath 复制包到项目 vendor 目录
update 从 $gopath 更新依赖包到项目 vendor 目录
remove 从 vendor 目录移除依赖的包
status 列出所有缺失、过期和修改过的包
fetch 从远程仓库添加或更新包到项目 vendor 目录(不会存储到 $gopath)
sync 根据 vendor.json 拉取相匹配的包到 vendor 目录
migrate 从其他基于 vendor 实现的包管理工具中一键迁移
get 与 go get 类似,将包下载到 $gopath,再将依赖包复制到 vendor 目录
license 列出所有依赖包的 license
shell 可一次性运行多个 govendor 命令
govendor 状态参数状态缩写含义
+local l 本地包,即项目内部编写的包
+external e 外部包,即在 gopath 中、却不在项目 vendor 目录
+vendor v 已在 vendor 目录下的包
+std s 标准库里的包
+excluded x 明确被排除的外部包
+unused u 未使用的包,即在 vendor 目录下,但项目中并未引用到
+missing m 被引用了但却找不到的包
+program p 主程序包,即可被编译为执行文件的包
+outside
相当于状态为 +external +missing
+all
所有包
支持状态参数的子命令有:list、add、update、remove、fetch
go modules普大喜奔的是,从 go 1.11 版本开始,官方已内置了更为强大的 go modules 来一统多年来 go 包依赖管理混乱的局面(go 官方之前推出的 dep 工具也几乎胎死腹中),并且将在 1.13 版本中正式默认开启。
目前已受到社区的看好和强烈推荐,建议新项目采用 go modules。
以上就是浅谈go包依赖管理工具govendor的详细内容。
其它类似信息

推荐信息