golang包管理工具dep使用简明教程

无风

为什么需要包管理

  • 锁住依赖版本,防止第三方包升级导致代码不兼容,因为go get默认拉取最新版本
  • 减少公共依赖、依赖耦合,将项目的依赖都放在项目vendor下,不依赖gopath下的公共包
  • 方便在新环境快速进入开发状态

安装

dep需要golang版本在1.9以上

各系统安装方法见官方文档:

https://golang.github.io/dep/...

设置代理

因为墙的缘故,使用广泛的golang.org旗下的包会同步失败,所以使用之前请先设置命令行代理,梯子自备(注意:设置全局代理对命令行不起作用)

export {http,https}_proxy='127.0.0.1:1080'

小技巧,设置命令alias,加入.bashrc

# 开启
alias setss='export {http_proxy,https_proxy}=http://127.0.0.1:1080'
# 关闭
alias noss='unset {http_proxy,https_proxy}'
# 测试
alias tss='curl -Li ip.cn'

dep工作流

  • 新建项目
    // 项目需要创建在gopath下
    cd $GOPATH/src
    mkdir my-project
    dep init -v
  • dep init 新项目或还未使用包管理的项目初始化

    init会分析go文件中import的包并安装,将依赖信息写入Gopkg.toml文件,安装的revision写入Gopkg.lock文件

  • dep ensure 同步依赖包 一个命令可以完成包的安装缺失的包、卸载无用的包,使代码中的import、lock文件、vendor中的包保持同步
  • Gopkg.toml这个文件主要是用来人工修改的,可以添加一些限制条件,Gopkg.lock才是真正的版本信息
  • dep ensure -add [package name] 安装指定包
  • dep ensure -update [package name] 更新指定包
  • dep ensure -update 更新所有包
  • dep status 查看同步状态

详细玩法请移步dep官方文档

旧项目改造

  1. 进入项目根目录运行dep init -gopath -v

    解释一下常用参数:

    -gopath 从本地的gopath获取包版本

    -v verbose

    -skip-tools dep会自动从之前的包管理文件中加载版本信息,如govendor,glide等。如果你不想从之前的包管理迁移可以加上此参数

  2. 将Gopkg.toml和Gopkg.lock提交到git,推荐将vendor也提交到git(go的依赖都比较小)
  3. 之后添加或更新依赖包都使用dep来操作

使用dep可能存在的坑

  • 因为墙的缘故,请务必设置命令行代理
  • 使用dep时尽量带上 -v 命令,如果半分钟没响应就ctrl+c中断,就可以看到fail的原因,dep遇到一些错误不会立马报错(特别是网络原因)
  • 私有库的问题,比如gitlab上的,参考这篇文章https://segmentfault.com/a/11...。经测试,其实也不用在toml里写密码,只要你在电脑上git设置了保存密码或者配置了ssh。简单来说就是直接用git clone不需要输入密码确认之类的就能用dep down下来了

这是之前整理的dep使用攻略,随着golang1.11发布,go mod已经上线,以后应该会迁移到go mod。不过目前go mod还不成熟,很多项目也没有激进的升级到1.11版本,dep还有用武之地。

go mod简明教程已更新: https://segmentfault.com/a/11...

阅读 8.7k

无风的内存空间
编程相关,随手记下
633 声望
55 粉丝
0 条评论
633 声望
55 粉丝
文章目录
宣传栏