长期以来,golang 对外部依赖都没有很好的管理方式,只能从 $GOPATH 下查找依赖。这就造成不同用户在安装同一个项目适合可能从外部获取到不同的依赖库版本,同时当无法联网时,无法编译依赖缺失的项目。
自 1.5 版本开始引入 govendor 工具,该工具将项目依赖的外部包放到项目下的 vendor 目录下(对比 nodejs 的 node_modules 目录),并通过 vendor.json 文件来记录依赖包的版本,方便用户使用相对稳定的依赖。
对于 govendor 来说,主要存在三种位置的包:项目自身的包组织为本地(local)包;传统的存放在 $GOPATH 下的依赖包为外部(external)依赖包;被 govendor 管理的放在 vendor 目录下的依赖包则为 vendor 包。
具体来看,这些包可能的类型如下:
状态 | 缩写状态 | 含义 |
---|---|---|
+local | l | 本地包,即项目自身的包组织 |
+external | e | 外部包,即被 $GOPATH 管理,但不在 vendor 目录下 |
v | 已被 govendor 管理,即在 vendor 目录下 | |
s | 标准库中的包 | |
u | 未使用的包,即包在 vendor 目录下,但项目并没有用到 | |
m | 代码引用了依赖包,但该包并没有找到 | |
p | 主程序包,意味着可以编译为执行文件 | |
外部包和缺失的包 | ||
所有的包 |
常见的命令如下,格式为govendor COMMAND
。
通过指定包类型,可以过滤仅对指定包进行操作。
功能 |
---|
初始化 vendor 目录 |
列出所有的依赖包 |
添加包到 vendor 目录,如 govendor add +external 添加所有外部包 |
添加指定的依赖包到 vendor 目录 |
从 $GOPATH 更新依赖包到 vendor 目录 |
从 vendor 管理中删除依赖 |
列出所有缺失、过期和修改过的包 |
添加或更新包到本地 vendor 目录 |
本地存在 vendor.json 时候拉去依赖包,匹配所记录的版本 |
类似go get 目录,拉取依赖包到 vendor 目录 |