标签：依赖 vendor dep 管理工具 仓库 golang Gopkg ensure
介绍
go dep 依赖管理工具是为应用管理代码的，go get是为GOPATH管理代码的
dep 需要在Go 1.7及更高的版本中使用
安装
本文使用 golang 版本是 go1.9.3 需要自己安装 dep
go get -v -u github.com/golang/dep/cmd/dep
基础帮助参数
dep
Dep is a tool for managing dependencies for Go projects
Usage: "dep [command]"
Commands:
init Set up a new Go project, or migrate an existing one
status Report the status of the project's dependencies
ensure Ensure a dependency is safely vendored in the project
prune Pruning is now performed automatically by dep ensure.
version Show the dep version information
Examples:
dep init set up a new project
dep ensure install the project's dependencies
dep ensure -update update the locked versions of all dependencies
dep ensure -add github.com/pkg/errors add a dependency to the project
Use "dep help [command]" for more information about a command.ensure 确保，确保所有本地状态-代码树、依赖列表、锁、远端oss彼此同步
使用
初始化
dep init -v # 更建议使用，因为会很漫长
会生成两个文件 Gopkg.lock、Gopkg.toml 和一个目录 vendor
如果报错 Gopkg.toml and Gopkg.lock are out of sync 需要执行一下 dep ensure -v
其中
Gopkg.toml是依赖管理的核心文件，可以生成也可以手动修改，Gopkg.toml 官方文档Gopkg.lock是生成的文件，不要手工修改 Gopkg.lock 官方文档vendor目录是 golang1.5 以后依赖管理目录，这个目录的依赖代码是优先加载的，类似 node 的node_module目录.
依赖管理
# 依赖管理帮助
dep help ensure
# 添加一条依赖
dep ensure -add github.com/bitly/go-simplejson
# 这里 @= 参数指定的是 某个 tag
dep ensure -add github.com/bitly/go-simplejson@=0.4.3
# 添加后一定记住执行 确保 同步
dep ensure
# 同理建议使用
dep ensure -v
# 更新依赖
dep ensure -update -v
# 删除没有用到的 package
dep prune -v依赖更新
编辑 Gopkg.toml 文件，配置新的依赖，然后执行
dep ensure -update -v && dep ensure -v
注意，这个和更新依赖是完全不同的概念，因为 dep 依赖 vendor 目录，所以会出现一种奇怪的情况
toml 文件修改了，但是依赖没有在 vendor 目录出现，这点你需要学习 node_module 修复大法
删除 vendor 目录中对应的内容，或者干掉整个 vendor 目录
dep 管理存在的问题
- 远程仓库拉取会比较困难，比如 golang.org 的，这个你得自己想办法，比如使用镜像，或者把依赖扔 vendor 目录
- 因为可以发现跨模块的代码拷贝，导致拉取依赖失败，因为 dep 是拷贝仓库代码，报错会比较摸不到头脑，建议仔细比对日志
- 因为 go 的依赖管理实际就是 git 的仓库拉取，如果依赖的仓库没有打 tag, 那么dep 会使用离 HEAD 提交最近的一次 tag,导致编译经常不通过.
临时解决方法是修改 Gopkg.toml 将有问题的仓库 version 注释掉，branch 切换到可以的分支
[[constraint]]
branch = "master"
name = "github.com/xx/xxx"
#version = ""最好的方法还是给依赖仓库打 tag
持续集成使用 dep 管理依赖
这里就不介绍一个 dep 管理实例了，因为环境不一样，使用的CI CD链不一样，除了脚本可以通用，其他内容都超过了本文的范围，所以主要讲些原则上的事情
持续集成时，使用 dep 的基本原则
- 尽量使用
tag 作为版本号，不使用分支（tag 就是不可维护分支，能固化版本，分支没有这个能力） - 禁止
非 vendor依赖方式编译 使用 Makefile 或者 shell 控制集成过程参数化部署控制，做好 测试 灰度 生产的分离，这里推荐 viper 参数配置工具
代码提交版本管理
-
Gopkg.toml和Gopkg.lock全部vendor目录都提交，git 仓库压力很大，但是可以做到减少远程依赖.这种方式可以做到开箱即用
-
让工程只保留
Gopkg.toml和Gopkg.lock，减少仓库代码大小，降低仓库压力
这种方式，每次构建就得执行dep ensure -v
我倾向于选择提交全部 vendor, 原因是远程仓库的依赖拉取非常慢，容易拖慢构建
如果git 仓库压力很大，可以做缓存仓库迁移分离压力，当然得写脚本批量修改 golang 代码的引用当然你还有一个选择，将 vendor 做成一个共享目录，编译时挂载到编译工程，这样既让 git 仓库的压力变小，也不被远程仓库网速问题困扰，缺点就是得额外维护脚本
构建过程的控制
- 因为 ${GOPATH} 环境变量的特殊性，不建议直接使用类似 jenkins 这种虚拟命令行构建，容易导致各种混乱（复数GOPATH，虽然可行，但存在环境串扰，降低编译速度，甚至报错的问题）
- 使用 docker 临时容器构建，输出构建的目标二进制和报告作为结果是最好的选择
- 如果是服务型的构建，可以直接使用 docker 容器编排测试服务
标签：依赖,vendor,dep,管理工具,仓库,golang,Gopkg,ensure 来源： https://blog.csdn.net/cpongo6/article/details/89249341
本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享； 2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关； 3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关； 4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除； 5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。