GO语言(二十七):管理依赖项(下)-

Python015

GO语言(二十七):管理依赖项(下)-,第1张

当您对外部模块的存储库进行了 fork (例如修复模块代码中的问题或添加功能)时,您可以让 Go 工具将您的 fork 用于模块的源代码。这对于测试您自己的代码的更改很有用。

为此,您可以使用go.mod 文件中的replace指令将外部模块的原始模块路径替换为存储库中 fork 的路径。这指示 Go 工具在编译时使用替换路径(fork 的位置),例如,同时允许您保留import 原始模块路径中的语句不变。

在以下 go.mod 文件示例中,当前模块需要外部模块example.com/theirmodule。然后该replace指令将原始模块路径替换为example.com/myfork/theirmodule模块自己的存储库的分支。

设置require/replace对时,使用 Go 工具命令确保文件描述的需求保持一致。使用go list命令获取当前模块正在使用的版本。然后使用go mod edit命令将需要的模块替换为fork:

注意: 当您使用该replace指令时,Go 工具不会像添加依赖项中所述对外部模块进行身份验证。

您可以使用go get命令从其存储库中的特定提交为模块添加未发布的代码。

为此,您使用go get命令,用符号@指定您想要的代码 。当您使用go get时,该命令将向您的 go.mod 文件添加一个 需要外部模块的require指令,使用基于有关提交的详细信息的伪版本号。

以下示例提供了一些说明。这些基于源位于 git 存储库中的模块。

当您的代码不再使用模块中的任何包时,您可以停止将该模块作为依赖项进行跟踪。

要停止跟踪所有未使用的模块,请运行go mod tidy 命令。此命令还可能添加在模块中构建包所需的缺失依赖项。

要删除特定依赖项,请使用go get,指定模块的模块路径并附加 @none,如下例所示:

go get命令还将降级或删除依赖于已删除模块的其他依赖项。

当您使用 Go 工具处理模块时,这些工具默认从 proxy.golang.org(一个公共的 Google 运行的模块镜像)或直接从模块的存储库下载模块。您可以指定 Go 工具应该使用另一个代理服务器来下载和验证模块。

如果您(或您的团队)已经设置或选择了您想要使用的不同模块代理服务器,您可能想要这样做。例如,有些人设置了模块代理服务器,以便更好地控制依赖项的使用方式。

要为 Go 工具指定另一个模块代理服务器,请将GOPROXY 环境变量设置为一个或多个服务器的 URL。Go 工具将按照您指定的顺序尝试每个 URL。默认情况下,GOPROXY首先指定一个公共的 Google 运行模块代理,然后从模块的存储库直接下载(在其模块路径中指定):

您可以将变量设置为其他模块代理服务器的 URL,用逗号或管道分隔 URL。

Go 模块经常在公共互联网上不可用的版本控制服务器和模块代理上开发和分发。您可以设置 GOPRIVATE环境变量。您可以设置GOPRIVATE环境变量来配置go命令以从私有源下载和构建模块。然后 go 命令可以从私有源下载和构建模块。

GOPRIVATE或环境变量可以设置为匹配模块前缀的全局模式列表,这些GONOPROXY前缀是私有的,不应从任何代理请求。例如:

Golang 配置不是这里要讨论的新话题。但是在Go 1.12发布之后,我认为必须重新定义步骤,因为项目设置变得比以前简单明了。

在搜索配置步骤时,除了少数文章之外,大部分内容仍然是分享旧方式,即

通过本文,我们将看到项目设置及其发布如何在Go 1.12版本中进行。

在1.11版本中,Go引入了名为Go Modules的内置包管理,它正在开始进行重大改变Go生态系统。它是GOPATH的替代品,集成了版本控制和软件包分发支持。

来自Go博客,

由于1.12版本的Go模块默认启用,GOPATH将在1.13版本中弃用。

对于那些开始使用Go 1.12的人来说,安装和设置将如下所示。

安装Go

在Mac上

在Ubuntu上

*从Go 1.8开始,将GOPATH设置为环境变量不是必需的。如果我们没有设置一个,Go使用默认的GOPATH为 $HOME/go

构建项目

让我们在GOPATH之外的首选位置为go项目创建文件夹

初始化模块

使用Go模块初始化项目名称。

这将创建模块配置文件go.mod,其中包含模块名称和版本。

此go.mod文件定义Module的根,go命令将相应地与包一起使用,作为GOPATH的替代。

使用模块

Go模块主要解决以下用例,

依赖管理

让我们使用jsoniter设置简单的json数据生成应用程序。

该go.mod配置的工作通常喜欢gemfile用Ruby,requirement.txtPython中或其他依赖管理工具,但不完全是。

构建go时,将根据go代码中的import语句获取最新版本的依赖项,并go.mod使用所需的依赖项更新配置。

对于我们的示例,go build将获取最新的jsoniter及其依赖项。

每次go.mod得更新,go build命令创建一个名为的文件,go.sum其中包含特定模块版本内容的预期加密校验和。

go.sum 不是锁 文件。它仅用于验证目的。有关详细信息,请参阅这里 FAQ。

解决自定义包

让我们创建一个自定义包并验证它是否在没有GOPATH的情况下得到解决。我创建了一个名为的包handlers

编写一个函数

使用main.go中的自定义包功能,

现在go build解析没有GOPATH的自定义包。二进制文件将在指定的模块名称中创建go.mod 。

让我们执行结果。

总结

模块系统将帮助我们为Go生态系统提供更好的身份验证和构建速度。

事情是这样的,因为小马本次要写一个go项目。但是因为一些权限问题,一些依赖包在内网小马获取不到,于是只能求助大大。大大给的策略就是他先把所有的依赖包go mod,然后go mod vendor迁移到项目目录vendor下进行本地依赖载入即可,也就是使用 go build -mod=vendor来编译即可。一切似乎看起来还是那么完美。然后正要起飞,直接翻车,现场如下。【这里插播一条发现,就是使用golang IDE go build 和使用命令行go build 的区别在于前者不会生成.exe文件】

将大大go mod vendor完的包pull到本地,只要编译就会发生如下错误(以下省略了一部分类似的报错)。其实是 go.mod内的所有依赖包都报错。

大大说他的本地编译是正常的。不得不怀疑是不是因为大大本地gopath还有一份包依赖的原因,然而经查并不是这个问题。翻阅了网络上的大部分资料无果,网络上要么是说是因为识别不到包,按照提示重新go mod vendor一下就可以了。小马蛮试了一下,不出所料必然地报远程报获取不到呢,IDE的报错定位其实是不准确的。再次检查vendor/modules.txt文件,没有问题,无果。 于是开始质疑golang IDE 的版本支持问题,无果。看了下go.mod文件中写着go 1.14,也没错呢,小马用的GO SDK正是1.14.4版本。敲出go env 查看环境配置,GO111MODULE=on,因为环境变量是auto,但是go到一定版本后默认是on,也没问题,无果。那问题出在哪呢?由于没有依赖包拉取权限,只能再次求助大大,大大表示也很奇怪,一番折腾,于是问题得到解决。【这里插播一条好玩的东西,就是GO111MODULE为什么是GO111呢,因为其实1.11版本开始支持MODULE的】

结论是:因为大大go  mod的时候用的是go 1.13,而我编译的时候用的 1.14,所以就报了这个奇怪的错误。you what?直接懵逼。但是为啥go.mod文件中写的版本要求是1.14,而大大用1.13也编译得好好的。

这是个大坑,掉进坑里自己扑腾了一天!!希望大家谨慎入坑。

爬坑一小时出坑一秒钟,每一次的爬坑都是充满着十八般绝技。奇怪的姿势又增加了。

go运行方式有哪几种?

如果GO111MODULE是auto则根据项目目录位置和是否含有go.mod文件来决定使用什么模式。如果是GO111MODULE=off则使用gopath,如果是on则使用module模式。gopath模式下的src目录下不能有go.mod文件,否则报错。

一些go mod命令 记录备用,国内的资料并不多(注意go mod 命令在 $GOPATH 里默认是执行不了的,因为 GO111MODULE 的默认值是 auto。默认在$GOPATH 里是不会执行, 如果一定要强制执行,就设置环境变量为 on。):