Go Module 工程化实践（一）：基础概念篇

时间  2019-11-07
标签 module 工程 实践 基础 概念 繁體版
原文   原文链接
人的一切痛苦，本質上都是對本身的無能的憤怒。 -- 王小波

1. 基础概念篇

Go Module已经来了，默认Go Module模式将会在1.13版本发布。也就是说半年后，就会全面铺开。鉴于官方提供扫盲文档中的样例过于简单，提供一个更加贴近实际开发过程的例子也许是有必要的。git

官方文档参考：Go Module Wiki。github

1.1 准备环境

按照官方的说明，Go Module是在 Go 的 1.11版本开始引入，可是默认该选项是关闭的，直到1.13版本将会默认开启。预计1.13将会在2019年8月份发布。因此在这以前，是必须手动开启Go Module支持。golang

必要条件：算法

  • Go语言版本 >= 1.11
  • 设置环境变量 GO111MODULE=on

在开启Go Module功能后，官方还提供了环境变量GOPROXY用于设置包镜像服务。此处暂不详细介绍了。缓存

1.2 Go Module带来的改变

1.2.1 GOPATH做用的改变

引入Go Module后，环境变量GOPATH仍是存在的。开启Go Module功能开关后，环境变量GOPATH的做用也发生了改变。函数

When using modules, GOPATH is no longer used for resolving imports. However, it is still used to store downloaded source code (in GOPATH/pkg/mod) and compiled commands (in GOPATH/bin).

翻译出来就是：工具

  • 环境变量GOPATH再也不用于解析imports包路径，即原有的GOPATH/src/下的包，经过import是找不到了。
  • Go Module功能开启后，下载的包将存放与$GOPATH/pkg/mod路径
  • $GOPATH/bin路径的功能依旧保持。

1.2.2 新增go.mod文件配置

开始Go Module开发以前，首先是初始化一个正确的Go Module定义，即go.mod文件。
何为正确的Go Module定义。就是说mod包必须符合。学习

方法一：测试

  • 在$GOPATH/src的目录下，建立合理的路径github.com/liujianping/foo路径。
  • 进入$GOPATH/src/github.com/liujianping/foo路径，执行go mod init便可。

或者ui

方法二：

  • 建立foo路径，位置任意
  • 进入foo目录，执行go mod init github.com/liujianping/foo便可。

生成了go.mod文件后，就该文件的语法简单的学习一下。

  • module
    to define the module path;
  • go
    to set the expected language version;
  • require
    to require a particular module at a given version or later;
  • exclude
    to exclude a particular module version from use; and
  • replace
    to replace a module version with a different module version.

官方提供了一个简单全面的例子：

module my/thing
go 1.12
require other/thing v1.0.2
require new/thing/v2 v2.3.4
exclude old/thing v1.2.3
replace bad/thing v1.4.5 => good/thing v1.4.5

1.2.3 go get流程改变

引入Go Module以后，go get官方又从新实现了一套。具体实现代码能够参考：

  • 不开启Go Module功能，go get代码实现
$GOROOT/src/cmd/go/internal/get/get.go
  • 开启Go Module功能，go get代码实现
$GOROOT/src/cmd/go/internal/modget/get.go

简单说明一下主要区别，更详细的go get取包原理放到下篇讲解。最直接的区别是：

  • 老的go get取包过程相似：git clone + go install , 开启Go Module功能后go get就只有 git clone 或者 download过程了。
  • 新老实现还有一个不一样是，二者存包的位置不一样。前者，存放在$GOPATH/src目录下；后者，存放在$GOPATH/pkg/mod目录下。
  • 老的go get取完主包后，会对其repo下的submodule进行循环拉取。新的go get再也不支持submodule子模块拉取。

1.3 一个完整的例子

官方的版本因为过于简单，连一个基础的本地第三方包的引入都没有，仅仅经过引入一个公开的第三方开源包，缺乏了常规本地开发说明。因此，笔者特地提供一个完整的例子，分别从：

  • 本地仓库
  • 远程仓库
  • 私有仓库

三个维度阐释Go Module的在实际开发中的具体应用。

本例子的目录结构以下:

$GOPATH/src
├── github.com
    └── liujianping
        ├── demo
        │   └── go.mod
        └── foo
            └── go.mod

建立两个mod模块：demo 与 foo, 其中 foo 做为一个依赖包，提供简单的 Greet 函数供 demo 项目调用。

1.3.1 本地仓库

本地仓库的意思，就是例子中的两个包: github.com/liujianping/demo 与 github.com/liujianping/foo 暂时仅仅存在于本地。没法经过 go get 直接从github.com 上获取。

经过如下命令，简单的建立项目代码：

$: mkdir -p $GOPATH/src/github.com/liujianping/foo
$: cd $GOPATH/src/github.com/liujianping/foo
$: go mod init
$: cat <<EOF > foo.go
package foo

import "fmt"

func Greet(name string) string {
    return fmt.Sprintf("%s, 你好！", name)
}
EOF

$: mkdir -p $GOPATH/src/github.com/liujianping/demo
$: cd $GOPATH/src/github.com/liujianping/demo
$: go mod init
$: cat <<EOF > main.go
package  main

import ( 
    "fmt"
    "github.com/liujianping/foo"
)

func main(){
    fmt.Println(foo.Greet("GoModule"))    
}
EOF

执行完以上命令之后，mod demo 与 foo 的代码部分就完成了。如今来执行如下：

$: cd $GOPATH/src/github.com/liujianping/demo
$: go run main.go
build github.com/liujianping/demo: cannot find module for path github.com/liujianping/foo

从输出能够看出，在demo 中调用 foo的依赖包，在编译过程就失败了。demo没法找到
github.com/liujianping/foo。为何这样？

按照传统的$GOPATH引入包原则，只要在$GOPATH/src存在相应路径的包，就能够完成编译了。从如今的情形就能够解释$GOPATH在Go Module功能开启后，对原有引入包的规则发生的改变。

既然，$GOPATH/src路径再也不支持。那么如何解决这个没法找到包依赖的问题呢？方法有二：

  • 本地路径
  • 远程仓库

该小节提供本地路径方法。

$: cat $GOPATH/src/github.com/liujianping/demo/go.mod
module github.com/liujianping/demo

目前demo项目的go.mod仅仅一句话，由于没法找github.com/liujianping/foo,因此在go build过程当中也不会修改go.mod，增长对包github.com/liujianping/foo的依赖关系。因此，只能是手动处理了。修改go.mod文件以下：

module github.com/liujianping/demo

require github.com/liujianping/foo v0.0.0
replace github.com/liujianping/foo => ../foo

再次执行demo程序：

$: go run main.go
go: finding github.com/liujianping/foo v0.0.0
GoModule, 你好！

对于项目中直接引用本地依赖包的官方文档中有段注意事项:

Note: for direct dependencies, a require directive is needed even when doing a replace. For example, if foo is a direct dependency, you cannot do replace foo => ../foo without a corresponding require for foo. (If you are not sure what version to use in the require directive, you can often use v0.0.0 such as require foo v0.0.0; see #26241).

意思就是，即便是本地依赖包，明确的require仍然是须要的。至于版本号，其实只要符合SemVer规范就能够。能够是v0.0.0,也能够是v0.1.2

Go Module最主要是引入了依赖包的版本控制。因此，咱们不妨就本地版本测试一下。

对本地版本foo进行相应的git本地版本控制，增长几个版本，代码中相应的增长版本信息。

package foo

import "fmt"

func Greet(name string) string {
    return fmt.Sprintf("%s, 你好！ Version 1.0.0", name)
}

增长了如下三个版本tag。

$: git tag
v0.1.0
v0.2.0
v1.0.0

在demo项目中，设置foo版本, go.mod修改以下：

module github.com/liujianping/demo

require github.com/liujianping/foo v0.1.0
replace github.com/liujianping/foo => ../foo

执行demo程序，输出以下：

go run main.go
go: finding github.com/liujianping/foo v0.1.0
GoModule, 你好！ Version 1.0.0

不可贵出结论：go get是不会从本地仓库获取版本信息的，查看go get在module模式下工具链实现代码也可得出这个结论。

1.3.2 远程仓库

从上节能够大体了解Go Module的原理。如今咱们将foo依赖包上传到github.com上，包括相应的版本tag。首先github.com建立相应的项目foo.再将本地仓库上传到远程仓库中。

$: git remote add origin git@github.com:liujianping/foo.git
$: git push -u origin master

上传版本tag信息：

$: git push origin --tags

如今完成了github.com/liujianping/foo依赖包的远程部署。看看具体实操demo项目，首先去掉本地的直接依赖。demo项目的go.mod以下

$: cat $GOPATH/src/github.com/liujianping/demo/go.mod
module github.com/liujianping/demo

从新执行demo项目

$: cd $GOPATH/src/github.com/liujianping/demo
$: go run main.go
go: finding github.com/liujianping/foo v1.0.0
go: downloading github.com/liujianping/foo v1.0.0
GoModule, 你好！ Version 1.0.0

查看变动后的go.mod,以下

$: cat go.mod
module github.com/liujianping/demo

require github.com/liujianping/foo v1.0.0 // indirect

同时demo根目录下，增长了go.sum文件。

cat go.sum
github.com/liujianping/foo v1.0.0 h1:yYoUzvOwC1g+4mXgSEloF187GmEpjKAHEmkApDwvOVQ=
github.com/liujianping/foo v1.0.0/go.mod h1:HKRu+NgbfULQV4mqZOnCXpF9IwlhOOIwmns7gpwjZic=

修改foo版本号到 v0.2.0

$: cat go.mod
module github.com/liujianping/demo

require github.com/liujianping/foo v0.2.0 // indirect

从新执行demo项目

$: cd $GOPATH/src/github.com/liujianping/demo
$: go run main.go
go: finding github.com/liujianping/foo v0.2.0
go: downloading github.com/liujianping/foo v0.2.0
GoModule, 你好！ Version 0.2.0

再看看go.sum文件发生的变化：

cat go.sum
github.com/liujianping/foo v0.2.0 h1:2JCV7mfUyneSksnWokX0kZoBbtWPoyL8s8iW80WHl/A=
github.com/liujianping/foo v0.2.0/go.mod h1:HKRu+NgbfULQV4mqZOnCXpF9IwlhOOIwmns7gpwjZic=
github.com/liujianping/foo v1.0.0 h1:yYoUzvOwC1g+4mXgSEloF187GmEpjKAHEmkApDwvOVQ=
github.com/liujianping/foo v1.0.0/go.mod h1:HKRu+NgbfULQV4mqZOnCXpF9IwlhOOIwmns7gpwjZic=

经过以上步骤，粗略能够了解针对Go Module对于远程仓库的版本选择。简单解释版本的选择过程下：

  • 检查远程仓库最新的tag版本，有就取得该版本
  • 远程仓库没有tag版本时，直接获取master分支的HEAD版本
  • 若是在go.mod文件中指定了具体版本，go get直接获取该指定版本
  • go.mod中除了能够指定具体版本号之外，还支持分支名

继续对远程版本foo增长新的版本v1.0.1。提交相应代码并推送版本标签v1.0.1到远端。并从新设置demo项目中的go.mod中的依赖版本为v1.0.0.以下：

$: cat go.mod
module github.com/liujianping/demo

require github.com/liujianping/foo v1.0.0 // indirect

从新执行demo项目

$: cd $GOPATH/src/github.com/liujianping/demo
$: go run main.go
GoModule, 你好！ Version 1.0.0

此次执行没有输出go自己的提示信息，而是直接输出告终果。由于github.com/liujianping/foo v1.0.0已经存在于本地的缓存中了，不妨查看一下。

$: ls $GOPATH/pkg/mod/github.com/liujianping/foo@v1.0.0

虽然就demo项目而言，依赖项目foo有两个v1.0.0与v1.0.1两个版本可用。按照GoModule版本选择最小版本的算法，demo项目依旧选择v1.0.0版本。

如何更新依赖包版本

更新依赖包的版本，最简单的方式，直接手动编辑go.mod设置依赖包版本便可。

另一种方式就是经过go get -u的方式进行自动更新。具体操做步骤以下：

查看依赖包版本更新信息

$: go list -u -m all
go: finding github.com/liujianping/foo v1.0.1
github.com/liujianping/demo
github.com/liujianping/foo v1.0.0 [v1.0.1]

更新依赖包版本

$: go get -u 
go: downloading github.com/liujianping/foo v1.0.1

或者，制定更新patch版本

$: go get -u=patch github.com/liujianping/foo 
go: downloading github.com/liujianping/foo v1.0.1

此时，go.mod文件即被更新

$: cat go.mod
module github.com/liujianping/demo

require github.com/liujianping/foo v1.0.1

从新执行程序

$: go run main.go
GoModule, 你好！ Version 1.0.1

基于分支

GoModule除了支持基于标签tag的版本控制，能够直接利用远程分支名称进行开发。

因此本节，笔者就模块foo建立一个新的远程分支develop.具体代码，请直接参考github.com/liujianping/foo项目。

修改demo项目的go.mod文件：

module github.com/liujianping/demo

require github.com/liujianping/foo develop

再次执行demo, 结果以下：

$: go run main.go
go: finding github.com/liujianping/foo develop
go: downloading github.com/liujianping/foo v1.0.2-0.20190214080857-9c0018d55446
GoModule, 你好！ Branch develop

查看，go.mod文件，发生以下变动：

$: cat go.mod
module github.com/liujianping/demo

require github.com/liujianping/foo v1.0.2-0.20190214080857-9c0018d55446

按官方文档的说明，使用分支名，能够直接拉取该分支的最后一次提交。从实验来看, Go Module一旦发生编译就会针对分支名的依赖进行版本号固定。

1.3.3 私有仓库

对于私有仓库而言，其原理与1.3.2中的远程仓库是相似的。惟一不一样之处是，go get取包的过程可能存在种种障碍，致使没法经过go get取到私有仓库包。主要缘由多是：

  • 权限问题
  • 路径问题

致使按照正常的go get过程取包失败。若是了解了go get取包原理，以上问题也就迎刃而解了。

更多文章可直接访问我的BLOG：GitDiG.com

相关阅读：

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程