go的依赖管理

Go依赖管理的演进

Go的依赖库主要经过三次迭代，分别为：

• GOPATH
• Go Vendor
• Go Module

依赖管理的主要目的：

• 根据不同环境不同项目使用不同依赖
• 控制依赖库的版本

GOPATH

GOPATH是Go中支持的一个环境变量，是项目的工作区。

//$GOPATH
.
|-- bin // 存放项目编译的二进制文件
|-- pkg // 存放项目编译的中间产物，加速编译
|-- src // 存放项目源码

$GOPATH/src目录下存放一切工程代码（所有.go文件，源代码），工程本身也是一个依赖包。

使用go get，我们能下载最新版本的包到src目录下，但go get无法传达版本信息，导致GOPATH模式没有版本控制的概念。这可能导致在运行Go程序时，无法保证其他人和你期望依赖的第三方库是一样的版本。又或者，如果有多个项目依赖同一个库，但它们分别依赖的是不同的版本，这时候也无法保证项目都能正常编译。

Go Proxy

模块代理是一个遵循GOPROXY 协议的服务器。它会缓存源站中的软件内容，实现了稳定可靠的依赖分发。

GOPROXY = "https://proxy1.cn, https://proxy2.cn, direct"
// proxy1 -> proxy2 -> direct

Go Modules通过GOPROXY环境变量控制如何使用 Go Proxy；GOPROXY是一个模块代理站点的URL列表，可以使用direct表示源站。对于如上配置，整体的依赖寻址路径，会优先从proxy1下载依赖，如果proxy1不存在，后在proxy2寻找，如果proxy2中也不存在则会回源到源站直接下载依赖，缓存到proxy站点中。

Go get

go get 命令可以借助代码管理工具通过远程拉取或更新代码包及其依赖包，并自动完成编译和安装。整个过程就像安装一个 App 一样简单。

这个命令可以动态获取远程代码包，目前支持的有 BitBucket、GitHub、Google Code 和 Launchpad。在使用 go get 命令前，需要安装与远程包匹配的代码管理工具，如 Git、SVN、HG 等，参数中需要提供一个包名。

这个命令在内部实际上分成了两步操作：第一步是下载源码包，第二步是执行 go install。下载源码包的 go 工具会自动根据不同的域名调用不同的源码工具，对应关系如下：

BitBucket (Mercurial Git)
GitHub (Git)
Google Code Project Hosting (Git, Mercurial, Subversion)
Launchpad (Bazaar)

所以为了 go get 命令能正常工作，你必须确保安装了合适的源码管理工具，并同时把这些命令加入你的 PATH 中。其实 go get 支持自定义域名的功能。

参数介绍：

• -d 只下载不安装
• -f 只有在你包含了 -u 参数的时候才有效，不让 -u 去验证 import 中的每一个都已经获取了，这对于本地 fork 的包特别有用
• -fix 在获取源码之后先运行 fix，然后再去做其他的事情
• -t 同时也下载需要为运行测试所需要的包
• -u 强制使用网络去更新包和它的依赖包
• -v 显示执行的命令

远程包的路径格式

Go语言的代码被托管于 Github.com 网站，该网站是基于 Git 代码管理工具的，很多有名的项目都在该网站托管代码。其他类似的托管网站还有 code.google.com、bitbucket.org 等。

这些网站的项目包路径都有一个共同的标准，参见下图所示。
 

图：远程包路径格式

图中的远程包路径是 Go语言的源码，这个路径共由 3 个部分组成：

• 网站域名：表示代码托管的网站，类似于电子邮件 @ 后面的服务器地址。
• 作者或机构：表明这个项目的归属，一般为网站的用户名，如果需要找到这个作者下的所有项目，可以直接在网站上通过搜索“域名/作者”进行查看。这部分类似于电子邮件 @ 前面的部分。
• 项目名：每个网站下的作者或机构可能会同时拥有很多的项目，图中标示的部分表示项目名称。

go get+ 远程包

默认情况下，go get 可以直接使用。例如，想获取 go 的源码并编译，使用下面的命令行即可：

$ go get github.com/davyxu/cellnet

获取前，请确保 GOPATH 已经设置。Go 1.8 版本之后，GOPATH 默认在用户目录的 go 文件夹下。

cellnet 只是一个网络库，并没有可执行文件，因此在 go get 操作成功后 GOPATH 下的 bin 目录下不会有任何编译好的二进制文件。

需要测试获取并编译二进制的，可以尝试下面的这个命令。当获取完成后，就会自动在 GOPATH 的 bin 目录下生成编译好的二进制文件。

$ go get github.com/davyxu/tabtoy

go get 使用时的附加参数

使用 go get 时可以配合附加参数显示更多的信息及实现特殊的下载和安装操作，详见下表所示。
 

go get 使用时的附加参数

附加参数	备  注
-v	显示操作流程的日志及信息，方便检查错误
-u	下载丢失的包，但不会更新已经存在的包
-d	只下载，不安装
-insecure	允许使用不安全的 HTTP 方式进行下载操作

 go get下载包的保存位置

使用echo %GOPATH%查看系统设置的GOPATH

• go get 下载的包保存在哪里呢？一般他会保存在这个目录：$GOPATH/src , 若你有多个GOPATH（工作区），则会保存在第一个工作区中。获取前，请确保 GOPATH 已经设置。Go 1.8 版本之后，GOPATH 默认在用户目录的 go 文件夹下。
• go get 检出或更新代码包之后，它会寻找与本地已安装Go语言的版本号相对应的标签（tag）或分支（branch）。比如，本机安装Go语言的版本是1.x，那么go get命令会在该代码包的远程仓库中寻找名为“go1”的标签或者分支。如果找到指定的标签或者分支，则将本地代码包的版本切换到此标签或者分支。如果没有找到指定的标签或者分支，则将本地代码包的版本切换到主干的最新版本。
• go get 更新代码包，更行代码包后，所引用此包的其他代码块使用时都会更新。但是就是不会更新vendor（govendor 代码包管理工具生成的文件夹）目录中的代码。

Go install 

go install 的编译过程有如下规律：

• go install 是建立在 GOPATH 上的，无法在独立的目录里使用 go install。
• GOPATH 下的 bin 目录放置的是使用 go install 生成的可执行文件，可执行文件的名称来自于编译时的包名。
• go install 输出目录始终为 GOPATH 下的 bin 目录，无法使用-o附加参数进行自定义。
• GOPATH 下的 pkg 目录放置的是编译期间的中间文件。