golang dep 依赖管理 使用
source link: https://studygolang.com/articles/13990?amp%3Butm_medium=referral
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
dep golang 包管理使用记录
dep 是 golang 项目依赖管理之一，是官方的实验项目，目前更新很频繁处于高速发展期，所以选 dep 作为 golang 的依赖管理器是比较靠谱的。（已知 glide 仅支持不再开发新功能）
目前 dep v0.5.0 release 已经发布，最新的 changelog 显示只支持 golang 1.9+ 以上的版本
golang 最原始的依赖管理是 go get ，执行命令后会拉取代码放入 src 下面，但是它是作为 GOPATH 下全局的依赖，并且 go get 还不能版本控制，以及隔离项目的包依赖在没有依赖管理工具的时候，golang 项目有一种目录结构比较流行如下：
.
└── src
├── demo
│ └── main.go
├── github.com
├── golang.org
└── gopkg.in
这样做的话就是每一个项目一个 GOPATH 则上面的 GOPATH=/xx/xx/src 这样设置后也是可以编译的，且项目依赖都是 src 下的包，与全局的无关联， go get
获取依赖，也必须在项目 GOPATH 下。可以看到这样的目录结构还是有很多缺陷的。特别是 import 包的包目录有时会很奇怪，没有统一的风格，且 ide 或 编辑器支持也不够理想。
所以目前 golang 引入了 vendor 目录作为依赖管理目录，且 ide 或 golang 编辑插件目前都能很好的支持 例如 gogland 索引依赖包时会优先查找项目根目录下的 vendor 目录， vscode 的 go 插件也是。那么目前比较流行的目录结构如下：
.
├── Gopkg.lock
├── Gopkg.toml
├── main.go
└── vendor
├── github.com
│ ├── gin-contrib
│ ├── gin-gonic
│ ├── golang
│ ├── mattn
│ └── ugorji
├── golang.org
│ └── x
└── gopkg.in
├── go-playground
└── yaml.v2
项目目录 $GOPATH/src/projectname/.
Getting Started
install / uninstall
macOS
brew install dep brew uninstall dep # /usr/local/bin/dep
windows
# 推荐 go get 安装 go get -u github.com/golang/dep/cmd/dep # $GOPATH/bin/dep.exe
Arch linux
pacman -S dep # 删除 pacman -R dep
二进制安装
curl https://raw.githubusercontent.com/golang/dep/master/install.sh | sh # $GOPATH/bin/dep # 删除 > rm $GOPATH/bin/dep
源码安装
go get -d -u github.com/golang/dep cd $(go env GOPATH)/src/github.com/golang/dep DEP_LATEST=$(git describe --abbrev=0 --tags) git checkout $DEP_LATEST go install -ldflags="-X main.version=$DEP_LATEST" ./cmd/dep git checkout master
推荐安装方式为 各系统的快捷安装，最方便且不容易出错， 如果想使用最新/指定版本，推荐源码安装
初始化项目
推荐使用上述第二种目录结构
mkdir $GOPATH/src/example cd $GOPATH/src/example dep init # 生成 vendor/ 目录下 Gopkg.toml Gopkg.lock
使用流程
Usage
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.
获取依赖策略
- 获取最新 TAG 的依赖包
dep ensure -add github.com/gin-gonic/gin
- 获取 指定分支 的依赖包
dep ensure -add github.com/gin-gonic/gin@master
- 获取 指定TAG 的依赖包
dep ensure -add github.com/gin-gonic/[email protected]
- 获取 指定TAG以上 的依赖包
dep ensure -add github.com/gin-gonic/gin@ ^V1.2
- 获取依赖包的 子包
dep ensure -add github.com/prometheus/client_golang/prometheus/push
获取两个子包的情况
dep ensure -add github.com/prometheus/client_golang/prometheus/push github.com/prometheus/client_golang/prometheus/promhttp
获取过程：根据命令先判断本地是否有缓存(缓存地址：$GOPATH/src/dep),存在则直接使用缓存，不存在则，先获取 git 版本/分支/tag 根据命令找到对应的版本下载。
FQAs
- 当拉取过程中如果出现 timeout 则请自备梯子.
- 当拉取出现未知的错误，可以先手动删除 缓存 在尝试一次
- 当出现 *build.NoGoError 错误，可能是 build 时当前依赖包并没有 main 函数，这种情况一般是需要拉取依赖包的子包
- 当已存在的项目 dep init 会遍历当前项目的依赖包，并下载，所以时间会很久
Recommend
-
244
dep is a dependency management tool for Go. It requires Go 1.9 or newer to compile. NOTE: Dep was an official experiment to implement a package manager for Go. As of 2020, Dep is deprecated and archived in favo...
-
141
v0.3.2
-
111
sam boyerNov 2017 NOTE: This is a WIP; the dep-check command does not exist yet. I'm putting this out there to get some feedback (feel free to just comment directly on the doc!); I’ll use the feedback to write the tool, then this will become the...
-
74
v0.4.0 of dep has been released - and along with it, this site for documentation and announcements about dep! And, being that it's been nearly six months since [the last dep status update](https://sdboyer.io/dep-status/2017-08-17/) (which are no...
-
37
v0.5.0 of dep has been [released](https://github.com/golang/dep/releases/tag/v0.5.0)!
-
67
Go Modules 是 Go 语言的一种依赖管理方式，该 feature 是在 Go 1.11 版本中出现的，由于最近在做的项目中，团队都开始使用 go module 来替代以前的 Godep，Kubernetes 也从 v1.15 开始采用 go module 来进行包管理，所以有必要了解一下 g...
-
19
package是基本复用模块单元。 注：以首字母大小写来区分是否可被包外代码访问。大写代表，可以被包外引入。 小写代表，不可被包外引入。 package名可以与目录名不一致。（但建议一致）
-
14
Journal 2019.25 - dep graphs, s3 transporter, spec 2 Probably the last update of the year. I had hoped to do it this weekly in 2019. That didn’t quite happen but since this is the 25th update of the year, I average about...
-
11
All Posts Go 包管理工具 dep 和 go module 的对比 @POST· 2021-02-24 20:33 · 11 min read 最近我将一些项目的依赖管理工具从 dep 迁移到了 go module，有一些爽的地方，也有一些不爽的地方，...
-
6
dep - SuRenPi dep ensure -update
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK