教程集 > Golang编程 > golang教程 > 正文 Go Modules与GOPROXY 配置

Go Modules与GOPROXY 配置

发布时间：2022-02-09 编辑：jiaochengji.com

教程集为您提供Go Modules与GOPROXY 配置等资源，欢迎您收藏本站，我们将为您提供最新的Go Modules与GOPROXY 配置资源

golangd 配置go mod 在博文底部

摘抄自https://studygolang.com/articles/24544 go语言中文网在原基础博客整理增加知识点让你彻底名表go mod
随着Go 1.13发布，GOPROXY默认值proxy.golang.org在中国大陆不能被访问。

七牛云顺势推出goproxy.cn，以利于中国开发者更好使用Go Modules，它是非盈利性的项目，首先感谢七牛云。

Windows下使用教程:

（1）升级到Go1.13

（2）运行<go env -w GO111MODULE=on> //开启mod

（3）运行<go env -w GOPROXY=https://goproxy.cn,direct> //设置七牛云goproxy代理

可以通过运行go env查看（2）、（3）步骤是否设置成功

（4）在项目跟目录下执行go mod init <OPTIONAL_MODULE_PATH>

执行成功后生成go.mod文件

其他指令

go get -u //更新现有的依赖
go mod tidy //整理模块（拉取缺少的模块，移除不用的模块）
go mod download//下载依赖包
go mod graph //打印现有依赖结构
go mod vendor //将依赖复制到vendor下
go mod verify //校验依赖
go.mod文件解析
module：模块名称，使用指令go mod init <OPTIONAL_MODULE_PATH>可设置
require：依赖包列表以及版本
exclude：禁用依赖包列表
replace：替换依赖包列表
go：go版本号

</blockquote>

goland编辑器中配置go mod

在goland的setting里设置启用Go Modules
goland Preference->Go->Go Modules(vgo) -> Enable Go Modules(vgo)intergration

</blockquote>

勾选 Enable Go Modules(vgo)intergration 之后，

</blockquote> <blockquote>

proxy配置(参考上图)
https://goproxy.cn
点击apply （应用）ok 即可。

</blockquote>

______________________________________________________________
______________________________________________________________

gomod 的相关知识摘抄自go 夜读（author：盛傲飞）

go.mod

<pre><code class="lang-go hljs">module sss go 1.13 require ( github.com/astaxie/beego v1.12.0 github.com/go-sql-driver/mysql v1.4.1 github.com/julienschmidt/httprouter v1.3.0 github.com/micro/examples v0.2.0 github.com/micro/go-micro v1.18.0 ) </code></pre>

go.mod 是启用了 Go moduels 的项目所必须的最重要的文件，它描述了当前项目（也就是当前模块）的元信息，每一行都以一个动词开头，目前有以下 5 个动词:

<ul><li>module：用于定义当前项目的模块路径。</li><li>go：用于设置预期的 Go 版本。</li><li>require：用于设置一个特定的模块版本。</li><li>exclude：用于从使用中排除一个特定的模块版本。</li><li>replace：用于将一个模块版本替换为另外一个模块版本。</li></ul>

这里的填写格式基本为包引用路径版本号，另外比较特殊的是 go $version，目前从 Go1.13 的代码里来看，还只是个标识作用，暂时未知未来是否有更大的作用。
go.sum
go.sum 是类似于比如 dep 的 Gopkg.lock 的一类文件，它详细罗列了当前项目直接或间接依赖的所有模块版本，并写明了那些模块版本的 SHA-256 哈希值以备 Go 在今后的操作中保证项目所依赖的那些模块版本不会被篡改。

<pre><code class="lang-go hljs">example.com/apple v0.1.2 h1:WX... example.com/apple v0.1.2/go.mod h1:xHW... example.com/banana v1.2.3/go.mod h1:HS... ... </code></pre> <pre><code class="lang-go hljs">example.com/apple v0.1.2 h1:WXk... example.com/apple v0.1.2/go.mod h1:xH... </code></pre>

前者为 Go modules 打包整个模块包文件 zip 后再进行 hash 值，而后者为针对 go.mod 的 hash 值。他们两者，要不就是同时存在，要不就是只存在 go.mod hash。

那什么情况下会不存在 zip hash 呢，就是当 Go 认为肯定用不到某个模块版本的时候就会省略它的 zip hash，就会出现不存在 zip hash，只存在 go.mod hash 的情况。

GO111MODULE
这个环境变量主要是 Go modules 的开关，主要有以下参数：

<ul><li>auto：只在项目包含了 go.mod 文件时启用 Go modules，在 Go 1.13 中仍然是默认值，详见：golang.org/issue/31857。</li><li>on：无脑启用 Go modules，推荐设置，未来版本中的默认值，让 GOPATH 从此成为历史。</li><li>off：禁用 Go modules。</li></ul>

GOPROXY
这个环境变量主要是用于设置 Go 模块代理，主要如下：

<ul><li>它的值是一个以英文逗号 “,” 分割的 Go module proxy 列表（稍后讲解）</li><li>作用：用于使 Go 在后续拉取模块版本时能够脱离传统的 VCS 方式从镜像站点快速拉取。它拥有一个默认值，但很可惜 proxy.golang.org 在中国无法访问，故而建议使用 goproxy.cn 作为替代。</li><li>设置为 “off” ：禁止 Go 在后续操作中使用任何 Go module proxy。</li></ul>

刚刚在上面，我们可以发现值列表中有 “direct” ，它又有什么作用呢？
其实值列表中的 “direct” 为特殊指示符，用于指示 Go 回源到模块版本的源地址去抓取 (比如 GitHub 等)，当值列表中上一个 Go module proxy 返回 404 或 410 错误时，Go 自动尝试列表中的下一个，遇见 “direct” 时回源，遇见 EOF 时终止并抛出类似 “invalid version: unknown revision…” 的错误。

GOSUMDB
它的值是一个 Go checksum database，用于使 Go 在拉取模块版本时(无论是从源站拉取还是通过 Go module proxy 拉取)保证拉取到的模块版本数据未经篡改，也可以是“off”即禁止 Go 在后续操作中校验模块版本

<ul><li>格式: SUMDB_NAME PUBLIC_KEY或SUMDB_NAME PUBLIC_KEY SUMDB_URL。</li><li>拥有默认值： sum.golang.org (之所以没有按照上面的格式是因为 Go 对默认值做了特殊处理)。</li><li>可被 Go module proxy 代理 (详见：Proxying a Checksum Database)。</li><li>GOSUMDB 的默认值在中国无法访问，故而更加建议将 GOPROXY 设置为 goproxy.cn，因为 goproxy.cn 支持代理 sum.golang.org。</li></ul>

Go Checksum Database
Go checksum database 主要用于保护 Go 不会从任何源头拉到被篡改过的非法 Go 模块版本，其作用（左）和工作机制（右）如下图：

如果有兴趣的小伙伴可以看看 Proposal: Secure the Public Go Module Ecosystem，有详细介绍其算法机制，如果想简单一点，查看 go helpmodule-auth 也是一个不错的选择。

GONOPROXY/GONOSUMDB/GOPRIVATE
这三个环境变量都是用在当前项目依赖了私有模块，也就是依赖了由 GOPROXY 指定的 Go module proxy 或由 GOSUMDB 指定 Go checksum database 无法访问到的模块时的场景，他们具有如下特性：

它们三个的值都是一个以英文逗号 “,” 分割的模块路径前缀，匹配规则同 path.Match。

</li><li>

其中 GOPRIVATE 较为特殊，它的值将作为 GONOPROXY 和 GONOSUMDB 的默认值，所以建议的最佳姿势是只是用 GOPRIVATE。

</li></ul>

在使用上来讲，比如 GOPRIVATE=*.corp.example.com 表示所有模块路径以 corp.example.com 的下一级域名 (如 team1.corp.example.com) 为前缀的模块版本都将不经过 Go module proxy 和 Go checksum database，需要注意的是不包括 corp.example.com 本身。
Global Caching
这个主要是针对 Go modules 的全局缓存数据说明，如下：

<ul><li>同一个模块版本的数据只缓存一份，所有其他模块共享使用。</li><li>目前所有模块版本数据均缓存在 $GOPATH/pkg/mod和 $GOPATH/pkg/sum 下，未来或将移至 $GOCACHE/mod和 $GOCACHE/sum 下( 可能会在当 $GOPATH 被淘汰后)。</li><li>可以使用 go clean-modcache 清理所有已缓存的模块版本数据。</li></ul>

另外在 Go1.11 之后 GOCACHE 已经不允许设置为 off 了，我想着这也是为了模块数据缓存移动位置做准备，因此大家应该尽快做好适配。

= = = = = = = = = = = = = = = = = = = =

<h2>快速迁移项目至 Go Modules</h2>

升级到 Go 1.13。

</li><li>

让 GOPATH 从你的脑海中完全消失，早一步踏入未来。

<ul><li>修改 GOBIN 路径（可选）。</li><li>打开 Go modules 的开关。</li><li>设置 GOPROXY。</li></ul></li><li>

按照你喜欢的目录结构重新组织你的所有项目。

</li><li>

在你项目的根目录下执行 go mod init<OPTIONAL_MODULE_PATH> 以生成 go.mod 文件。

</li><li>

想办法说服你身边所有的人都去走一下前四步。

</li></ul><h2>迁移后 go get 行为的改变</h2>

这里我们注意到有两点比较特别，分别是：

<ul><li>第一点：为什么 “拉取 hash 为 342b231 的 commit，最终会被转换为 v0.3.2” 呢。这是因为虽然我们设置了拉取 @342b2e commit，但是因为 Go modules 会与 tag 进行对比，若发现对应的 commit 与 tag 有关联，则进行转换。</li><li>第二点：为什么不建议使用 go mod vendor，因为 Go modules 正在淡化 Vendor 的概念，很有可能 Go2 就去掉了。</li></ul><h2>使用 Go Modules 时常遇见的坑</h2> <h3>坑 1: 判断项目是否启用了 Go Modules</h3>

<h3>坑 2: 管理 Go 的环境变量</h3>

这里主要是提到 Go1.13 新增了 go env-w 用于写入环境变量，而写入的地方是 os.UserConfigDir 所返回的路径，需要注意的是 go env-w 不会覆写。

<h3>坑 3: 从 dep、glide 等迁移至 Go Modules</h3>

这里主要是指从旧有的依赖包管理工具（dep/glide 等）进行迁移时，因为 BUG 的原因会导致不经过 GOPROXY 的代理，解决方法有如下两个：

<ul><li>手动创建一个 go.mod 文件，再执行 go mod tidy 进行补充。</li><li>上代理，相当于不使用 GOPROXY 了。</li></ul><h3>坑 4:拉取私有模块</h3>

这里主要想涉及两块知识点，如下：

<ul><li>GOPROXY 是无权访问到任何人的私有模块的，所以你放心，安全性没问题。</li><li>GOPROXY 除了设置模块代理的地址以外，还需要增加 “direct” 特殊标识才可以成功拉取私有库。</li></ul><h3>坑 5:更新现有的模块</h3>

Q：使用 Go modules 时可以同时依赖同一个模块的不同的两个或者多个小版本（修订版本号不同）吗？

A：不可以的，Go modules 只可以同时依赖一个模块的不同的两个或者多个大版本（主版本号不同）。比如可以同时依赖 example.com/foobar@v1.2.3 和 example.com/foobar/v2@v2.3.4，因为他们的模块路径（module path）不同，Go modules 规定主版本号不是 v0 或者 v1 时，那么主版本号必须显式地出现在模块路径的尾部。但是，同时依赖两个或者多个小版本是不支持的。比如如果模块 A 同时直接依赖了模块 B 和模块 C，且模块 A 直接依赖的是模块 C 的 v1.0.0 版本，然后模块 B 直接依赖的是模块 C 的 v1.0.1 版本，那么最终 Go modules 会为模块 A 选用模块 C 的 v1.0.1 版本而不是模块 A 的 go.mod 文件中指明的 v1.0.0 版本。

这是因为 Go modules 认为只要主版本号不变，那么剩下的都可以直接升级采用最新的。但是如果采用了最新的结果导致项目 Break 掉了，那么 Go modules 就会 Fallback 到上一个老的版本，比如在前面的例子中就会 Fallback 到 v1.0.0 版本。

<blockquote class="layui-elem-quote" style="width: 100%;overflow:hidden"> 作者： liuqun0319
链接： https://blog.csdn.net/liuqun0319/article/details/103213396
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。
</blockquote>

到此这篇关于“Go Modules与GOPROXY 配置”的文章就介绍到这了,更多文章或继续浏览下面的相关文章，希望大家以后多多支持JQ教程网！

您可能感兴趣的文章：
Golang包管理详解
 GOPROXY：解决 go get golang.org/x 包失败
 unrecognized import path “golang.org/x/...“ ...
Go Modules与GOPROXY 配置
 golang的go mod
golang https 代理_goproxy.cn - 为中国 Go 语言开发者量身打造的模块代理
 Go环境搭建以及Beego安装
 golang https 代理_goproxy.cn 为中国 Go 语言开发者量身打造的模块代理
 Go Module入门及Golang项目组织
 GO 依赖管理工具go Modules（官方推荐）

上一篇：golang-接口的大小下一篇：Go语言的return 与 defer 执行顺序

[关闭]

Go Modules与GOPROXY 配置

最近更新

浏览排行