跳出Go module的泥潭

栏目: Go · 发布时间: 6年前

内容简介:Go 1.11 前天已经正式发布了,这个版本包含了两个最重要的feature就是虽然有三个帮助文件我也在摸索中前行, 记录了摸索过程中的一些总结,希望能给还在挣扎中的Gopher一些帮助。

Go 1.11 前天已经正式发布了,这个版本包含了两个最重要的feature就是 moduleweb assembly 。虽然也有一些简单的教程介绍了 go module 的特性,但是基本上都是 hello world 的例子,在实践的过程中, 很多人都在“拼命的挣扎”,包括我自己, 从一些qq群、github的issue, twitter上都可以看到大家茫然或者抱怨的语句。

虽然有三个帮助文件 go help modgo help modulesgo help module-get 可以了解一些go module的用法,但是感觉 Go 开发组对 module 这一特性还是没有很好的做一个全面的介绍,很多情况还得靠大家看源代码或者去猜,比如module下载的文件夹、版本格式的完整声明, module 的最佳实践等,并且当前Go 1.11的实现中还有一些bug,给大家在使用的过程中带来了很大的困难。

我也在摸索中前行, 记录了摸索过程中的一些总结,希望能给还在挣扎中的Gopher一些帮助。

GO111MODULE

要使用 go module ,首先要设置 GO111MODULE=on ,这没什么可说的,如果没设置,执行命令的时候会有提示,这个大家应该都了解了。

既有项目

假设你已经有了一个go 项目, 比如在 $GOPATH/github.com/smallnest/rpcx 下, 你可以使用 go mod init github.com/smallnest/rpcx 在这个文件夹下创建一个空的 go.mod (只有第一行 module github.com/smallnest/rpcx )。

然后你可以通过 go get -m ./... 让它查找依赖,并记录在 go.mod 文件中(你还可以指定 -tags ,这样可以把tags的依赖都查找到)。

通过 go mod tidy 也可以用来为 go.mod 增加丢失的依赖,删除不需要的依赖,但是我不确定它怎么处理 tags

执行上面的命令会把 go.modlatest 版本换成实际的最新的版本,并且会生成一个 go.sum 记录每个依赖库的版本和哈希值。

新的项目

你可以在 GOPATH 之外创建新的项目。

go mod init packagename 可以创建一个空的 go.mod ,然后你可以在其中增加 require github.com/smallnest/rpcx latest 依赖,或者像上面一样让go自动发现和维护。

go mod download 可以下载所需要的依赖,但是依赖并不是下载到 $GOPATH 中,而是 $GOPATH/pkg/mod 中,多个项目可以共享缓存的module。

go mod命令

download    download modules to local cache
edit        edit go.mod from tools or scripts
graph       print module requirement graph
init        initialize new module in current directory
tidy        add missing and remove unused modules
vendor      make vendored copy of dependencies
verify      verify dependencies have expected content
why         explain why packages or modules are needed

有些命令还有bug, 比如 go mod download -dir :

go mod download -dir /tmp
flag provided but not defined: -dir
usage: go mod download [-dir] [-json] [modules]
Run 'go help mod download' for details.

帮助里明明说可以设置 dir ,但是实际却不支持 dir 参数。

看这些命令的帮助已经比较容易了解命令的功能。

翻墙

在国内访问 golang.org/x 的各个包都需要翻墙,你可以在 go.mod 中使用 replace 替换成github上对应的库。

replace (
	golang.org/x/crypto v0.0.0-20180820150726-614d502a4dac => github.com/golang/crypto v0.0.0-20180820150726-614d502a4dac
	golang.org/x/net v0.0.0-20180821023952-922f4815f713 => github.com/golang/net v0.0.0-20180826012351-8a410e7b638d
	golang.org/x/text v0.3.0 => github.com/golang/text v0.3.0
)

依赖库中的 replace 对你的主 go.mod 不起作用,比如 github.com/smallnest/rpcxgo.mod 已经增加了 replace ,但是你的 go.mod 虽然 requirerpcx 的库,但是没有设置 replace 的话, go get 还是会访问 golang.org/x

所以如果想编译那个项目,就在哪个项目中增加 replace

版本格式

下面的版本都是合法的:

gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7
gopkg.in/vmihailenco/msgpack.v2 v2.9.1
gopkg.in/yaml.v2 <=v2.2.1
github.com/tatsushid/go-fastping v0.0.0-20160109021039-d7bb493dee3e
latest

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

算法基础

算法基础

[美] 托马斯 H.科尔曼(Thomas H.Cormen) / 王宏志 / 机械工业出版社 / 2015-12 / 59.00

本书介绍了什么是计算机算法,如何描述它们,以及如何来评估它们。这些计算机算法将提供:利用计算机搜索信息的简单方式;解决各种排序问题的方法;利用有向无环图和最短路径法来解决基本问题的方法(可用于建模公路网络,任务间的依赖及金融关系);解决字符串(例如DNA结构)问题的方法;密码学背后的基本原理;数据压缩的基础知识;以及甚至一些没有人能够理解如何在计算机上用相当长的时间来解决的问题。 本书适合作......一起来看看 《算法基础》 这本书的介绍吧!

Base64 编码/解码
Base64 编码/解码

Base64 编码/解码

RGB CMYK 转换工具
RGB CMYK 转换工具

RGB CMYK 互转工具

HEX CMYK 转换工具
HEX CMYK 转换工具

HEX CMYK 互转工具