Go Modules介绍

为了解决Go包管理的问题,Go从1.11开始加入了Go Modules这一新特性。让包的依赖和版本管理更加容易。

一个module可以理解为一个单独的包或者模块,module的根目录下会包含一个go.mod文件。go.mod文件中定义了该module被其它包importpath,同时也包含了该module中依赖哪些包,和这些包的版本号。

  1. Go 1.11需要设置GO111MODULE来开启module功能
  2. GO111MODULE=on,会开启使用module
  3. GO111MODULE=auto默认值,会根据当前目前来决定是否开启module。如果当前目录在``GOPATH/src``之外且当前目录有``go.mod``文件或当前文件在包含go.mod文件的目录下面
  4. Go 1.13开始module被默认开启

创建一个module

GOPATH/src之外创建一个空的文件夹hello,打开这个文件夹,创建一个hello.go文件:

  1. package hello
  2. func Hello() string {
  3. return "Hello, world."
  4. }

写一个单测文件hello_test.go

  1. package hello
  2. import "testing"
  3. func TestHello(t *testing.T) {
  4. want := "Hello, world."
  5. if got := Hello(); got != want {
  6. t.Errorf("Hello() = %q, want %q", got, want)
  7. }
  8. }

运行go test命令,这个时候返回:

  1. PS D:\Code\hello> go test
  2. PASS
  3. ok _/D_/Code/hello 0.176s

可以看到当前的目录是在D:\Code\hello,既不是在GOPATH/src目录下,这时也不是一个module,但是go命令创造了一个假的module名称是:_/D_/Code/hello

我们这时运行go mod init 命令,创建一个module并且运行单测:

  1. go mod init example.com/hello
  2. go: creating new go.mod: module example.com/hello
  3. go test
  4. PASS
  5. ok example.com/hello 0.177s

可以看到case运行通过,并且返回ok example.com/hello 0.177s 是我们刚才创建的module。在目录下面也可以看到通过go mod init 创建了一个go.mod文件内容是:

  1. module example.com/hello
  2. go 1.14

mod文件只需要在module的根目录下创建就行了,子目录的import path是module的path加上子目录的地址。

添加外部依赖

在hello.go文件中导入一个外部的包:

  1. package hello
  2. import "rsc.io/quote"
  3. func Hello() string {
  4. return quote.Hello()
  5. }

运行单测:

  1. go: finding module for package rsc.io/quote
  2. go: found rsc.io/quote in rsc.io/quote v1.5.2
  3. --- FAIL: TestHello (0.00s)
  4. hello_test.go:8: Hello() = "你好,世界。", want "Hello, world."
  5. PASS
  6. ok example.com/hello 0.177s

这时打开go.mod文件:

  1. module example.com/hello
  2. go 1.14
  3. require rsc.io/quote v1.5.2

可以发现go会自动去找rsc.io/quote这个依赖的最新版本同时加入到go.mod文件中,再次运行单测:

  1. PASS
  2. ok example.com/hello 0.177s

可以发现go第二次已经不需要去找rsc.io/quote。运行go list -m all 返回:

  1. example.com/hello
  2. golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c
  3. rsc.io/quote v1.5.2
  4. rsc.io/sampler v1.3.0

可以看到引入外部依赖rsc.io/quote,也会带来它的间接依赖

除了go.mod文件,目录中也会增加一个go.sum文件内容如下:

  1. golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c h1:qgOY6WgZOaTkIIMiVjBQcw93ERBE4m30iBm00nkL0i8=
  2. golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
  3. rsc.io/quote v1.5.2 h1:w5fcysjrx7yqtD/aO+QwRjYZOKnaM9Uh2b40tElTs3Y=
  4. rsc.io/quote v1.5.2/go.mod h1:LzX7hefJvL54yjefDEDHNONDjII0t9xZLPXsUe+TKr0=
  5. rsc.io/sampler v1.3.0 h1:7uVkIFmeBqHfdjD+gZwtXXI+RODJ2Wc4O7MPEh/QiW4=
  6. rsc.io/sampler v1.3.0/go.mod h1:T1hPZKmBbMNahiBKFy5HrXp6adAjACjK9JXDnKaTXpA=

后面增加了每个外部依赖内容的hash值,go通过这些hash值去验证你下载依赖的正确性。

升级版本

通过上面的go list -m all可以看到 golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c 我们用到的版本是v0.0.0-20170915032832-14c0d48ead0c。我们接下来升级它的版本:

  1. go get golang.org/x/text
  2. go: golang.org/x/text upgrade => v0.3.3
  3. go: downloading golang.org/x/text v0.3.3
  4. go test
  5. PASS
  6. ok example.com/hello 0.199s

此时go.mod文件内容是:

  1. module example.com/hello
  2. go 1.14
  3. require (
  4. golang.org/x/text v0.3.3 // indirect
  5. rsc.io/quote v1.5.2
  6. )

可以看到golang.org/x/text v0.3.3 // indirect这个间接依赖已经被升级到v0.3.3了。

运行go list -m all 返回:

  1. example.com/hello
  2. golang.org/x/text v0.3.3
  3. golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e
  4. rsc.io/quote v1.5.2
  5. rsc.io/sampler v1.3.0

移除没有使用的依赖

运行go mod tidy 可以删除没有使用的包

下载依赖到当前目录

go mod vendor 会下载依赖到vendor中,只会下载你代码中的依赖,不会下载所有go.mod中引用的依赖

Go包管理go mod使用的更多相关文章

  1. go modules包管理

    记录一下go工程迁移go modules的过程. go mod golang从1.11版本之后引入了包管理-go mod,并通过环境变量GO111MODULE 设置: 默认GO111MODULE 为a ...

  2. Go 包管理历史以及 Go mod 使用

    之前也写过 Go 管理依赖工具 godep 的使用,当时看 godep 使用起来还是挺方便,其原因主要在于有总比没有强.关于依赖管理工具其实还是想从头聊聊这个需求以及大家做这个功能的各种出发点. GO ...

  3. golang包管理解决之道——go modules初探

    golang的包管理是一直是为人诟病之处,从golang1.5引入的vendor机制,到准官方工具dep,目前为止还没一个简便的解决方案. 不过现在go modules随着golang1.11的发布而 ...

  4. 拜拜了,GOPATH君!新版本Golang的包管理入门教程

    Go 1.11和1.12实现了对包管理的初步支持,Go的新依赖管理系统使依赖版本信息明确且易于管理.Using Go Modules - The Go Blog 新的包管理模式有什么不同? 作为Go语 ...

  5. [系列] 使用 go modules 包管理工具(一)

    目录 概述 初始化 添加依赖包 go mod 命令 小结 源码地址 概述 我想实现一个开箱即用的 API 框架的轮子,这个轮子是基于 Gin 基础上开发的. 为什么是开箱即用,它会集成哪些功能? 以上 ...

  6. golang包管理的古往今来

    https://golang.org/ before GO1.5-GOPATH 在GO1.5之前用GOPATH以及GOROOT这两个环境变量来决定包的位置. GOROOT就是告知当前go的安装位置,编 ...

  7. 使用 go modules 包管理工具(一)

    概述 我想实现一个开箱即用的 API 框架的轮子,这个轮子是基于 Gin 基础上开发的. 为什么是开箱即用,它会集成哪些功能? 以上功能点,都是常用的,后期可能还会增加. 废话不多说,咱们开始吧. 创 ...

  8. go包管理

    摘自: http://blueskykong.com/2019/02/18/go-dep-1/ https://www.cnblogs.com/apocelipes/p/10295096.html#v ...

  9. nexus 3.17.0 做为golang 的包管理工具

    nexus 3.17.0 新版本对于go 包管理的支持是基于go mod 的,同时我们也需要一个athens server 然后在nexus 中配置proxy 类型的repo 参考配置 来自官方的配置 ...

随机推荐

  1. s7-200高速脉冲输出与高速计数器讲解

    s7-200高速脉冲输出与高速计数器讲解

  2. Ray射线检测和Recources.Load

    记录射线检测常用的方法,以及Rocources.Load的常用用法 使用代码实现鼠标点击在鼠标点击处生成制定gameObject RayCastHit hit; void Update() { Ray ...

  3. lin-cms-dotnetcore功能模块的设计

    lin-cms-dotnetcore功能模块的设计 先来回答以下问题. 1.什么是cms? Content Management System,内容管理系统. 2.dotnetcore是什么? .NE ...

  4. Netty源码分析之自定义编解码器

    在日常的网络开发当中,协议解析都是必须的工作内容,Netty中虽然内置了基于长度.分隔符的编解码器,但在大部分场景中我们使用的都是自定义协议,所以Netty提供了  MessageToByteEnco ...

  5. java 基本类型详解 及 常见问题

    鄙人不才,基础不好,趁着闲时简单学习一下,仅作学习分享,如有不正确地方还请各位看客不吝指出. 常用的基本类型有:byte(8).short(16).char(16,取值从0-65535[2^16-1] ...

  6. python根据列表创建文件夹,拷贝指定文件

    内容涉及:关键字定位,列表去重复,路径组装,文件夹创建,文件拷贝,字符串分割 list.txt的内容为包含关键字的文件路径,如:关键字 ’181‘ org/20190523/1/20190523201 ...

  7. 主线程用afxBeginThread()创建多个线程安全退出的办法

    HANDLE hand[]; CCriticalSection m_crisecoin; CEvent m_event; struct Student { int nNO; int nYear; CW ...

  8. 理解C#中的ValueTask

    原文:https://devblogs.microsoft.com/dotnet/understanding-the-whys-whats-and-whens-of-valuetask/ 作者:Ste ...

  9. nginx 代理post请求做负载均衡

    项目中遇到nginx代理post请求nodejs服务.但是一直404.发现好像是nginx重定向的时候将post请求变成了get请求.上配置: # 负载均衡服务器配置 upstream pdf_ups ...

  10. 【Spring注解驱动开发】BeanPostProcessor在Spring底层是如何使用的?看完这篇我懂了!!

    写在前面 在<[String注解驱动开发]面试官再问你BeanPostProcessor的执行流程,就把这篇文章甩给他!>一文中,我们详细的介绍了BeanPostProcessor的执行流 ...