当前位置： 代码迷 >> 综合 >> Golang modules 初探
  详细解决方案

Golang modules 初探

热度：74   发布时间：2023-12-06 02:43:31.0

今天天色刚刚亮起，起床看到 golang 1.11 正式发版了，有着两个重要的特性：modules 和 WebAssembly。

本博文只要说的是 modules，congJava 转 golang 的同学肯定是对 golang 的包管理充满了无奈之情，我也曾在博客中介绍过 glide，也介绍过 dep，现在我们再一次升级介绍 modules。

什么是 modules

现在都在说 modules，那么它是什么？ 
到文档看看 Modules, module versions, and more：

 
  
    
   
  1. A module is a collection of related Go packages. Modules are the unit of source code interchange and versioning. The go command has direct support for working with modules, including recording and resolving dependencies on other modules. Modules replace the old GOPATH-based approach to specifying which source files are used in a given build.
    2. 
  
 
  
翻译一下：
 
  
 
  
    
   
  1. 模块是相关Go包的集合。modules是源代码交换和版本控制的单元。 go命令直接支持使用modules，包括记录和解析对其他模块的依赖性。modules替换旧的基于GOPATH的方法来指定在给定构建中使用哪些源文件。
    2. 
  
 
  
可以得到两个重要信息：
 
  
    
   
  • Go 命令行支持 modules 操作
    • 
   
  • modules 用来替换 GOPATH 的
    • 
  
 
  
大家不需要太担心了，golang 1.11 版本仅仅是指对 modules 的初步支持，之前老的 GOPATH 还是可以继续使用的，有人说是在 golang 1.12 去除，但是我觉得有点早了，毕竟人的惯性不是这么容易改变的。
 
  
如何使用 modules
 
  
modules 是一个新的特性，那么就需要新的 Golang 版本进行支持了，可以到官网下载，一定要是 go 1.11 及以上的版本（写博文的时候 go 1.11 刚刚出来）。
这么部署就在这里说了，相信初学者也是知道怎么做的。
 
  
还有人记得 vendor 刚刚出来时候 golang 提供的环境变量 GO15VENDOREXPERIMENT吗？现在 modules 出来，按照惯例也提供了一个环境变量 GO111MODULE，这个变量的三个 1 太有魔性了。
 
  
GO111MODULE
 
  
GO111MODULE可以设置为三个字符串值之一：off，on 或 auto（默认值）。
 
  
    
   
  • off，则 go 命令从不使用新模块支持。它查找 vendor 目录和 GOPATH 以查找依赖关系; 也就是继续使用 “GOPATH 模式”。
    • 
   
  • on，则 go 命令需要使用模块，go 会忽略 GOPATH 和 vendor 文件夹，只根据 go.mod 下载依赖。
    • 
   
  • auto 或未设置，则 go 命令根据当前目录启用或禁用模块支持。仅当当前目录位于 GOPATH/src 之外并且其本身包含 go.mod 文件或位于包含 go.mod 文件的目录下时，才启用模块支持。
    • 
  
 
  
Defining a module
 
  
开始的时候谁也不知道怎么使用？不过 go 已经给我提供了工具了，可以在控制台输入:
 
  
 
  
    
   
  1. go help modules
    2. 
  
 
  
看到一大串的文档输出，看着都头疼了，一会儿我们再简要说明重点，现在先进行操作。
 
  
 
  
    
   
  1. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka (module)
    2. 
   
  2. $ export GO111MODULE=on  #开启modules
    3. 
   
    4. 
   
  4. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka (module)
    5. 
   
  5. $ go mod init  gitlab.luojilab.com/zeroteam/ddkafka # 创建go.mod
    6. 
   
  6. go: creating new go.mod: module gitlab.luojilab.com/zeroteam/ddkafka
    7. 
   
    8. 
   
  8. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka (module)
    9. 
   
  9. $ ls    # 真的创建了，google大法好呀
    10. 
   
  10. README.md  go.mod  models.go  mq_interface.go  sarama  segmentio
    11. 
   
  11. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka (module)
    12. 
   
  12. $ cat go.mod    # 看看里面什么东西
    13. 
   
  13. module gitlab.luojilab.com/zeroteam/ddkafka
    14. 
   
  14. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka (module)
    15. 
   
  15. $ cd segmentio/
    16. 
   
  16. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka/segmentio (module)
    17. 
   
  17. $ go test   # 执行一下看看
    18. 
   
  18. go: finding github.com/segmentio/kafka-go latest
    19. 
   
  19. go: finding github.com/golang/glog latest
    20. 
   
  20. go: downloading github.com/golang/glog v0.0.0-20160126235308-23def4e6c14b
    21. 
   
  21. go: downloading github.com/segmentio/kafka-go v0.0.0-20180716203113-48c37f796910
    22. 
   
  22. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka/segmentio (module)
    23. 
   
  23. $ go list -m
    24. 
   
  24. gitlab.luojilab.com/zeroteam/ddkafka
    25. 
  
 
  
细心的同学一定可以发现，执行 go mod init [module]使用 go.mod只有一行信息 module gitlab.luojilab.com/zeroteam/ddkafka，在执行 go build、 go test、 go list 命令时会根据需要的依赖自动生成 require 语句。
 
  
现在来说说如何定义一个 modules，modules 是由 Go 源文件目录结构定义的，如果目录下含有 go.mod 文件，该目录称为模块根目录（module root）。模块根目录及其子目录所有的 Go 包都是属于该 modules 的，但是如果子目录包含有了自己的 go.mod 文件就隶属于该 modules。
举一个例子：
 
  
 
  
    
   
  1. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka (module)
    2. 
   
  2. $ tree
    3. 
   
  3. .
    4. 
   
  4. |-- README.md
    5. 
   
  5. |-- go.mod
    6. 
   
  6. |-- go.sum
    7. 
   
  7. |-- models.go
    8. 
   
  8. |-- mq_interface.go
    9. 
   
  9. |-- sarama
    10. 
   
  10. |   |-- sarama_consumer.go
    11. 
   
  11. |   |-- sarama_consumer_test.go
    12. 
   
  12. |   |-- sarama_producer.go
    13. 
   
  13. |   `-- sarama_producter_test.go
    14. 
   
  14. `-- segmentio
    15. 
   
  15.     |-- segmention_Consumer.go
    16. 
   
  16.     |-- segmention_consumer_test.go
    17. 
   
  17.     |-- segmention_producer.go
    18. 
   
  18.     `-- segmention_producter_test.go
    19. 
  
 
  
gitlab.luojilab.com/zeroteam/ddkafka目录下含有了 go.mod 文件，所以其子目录 sarama和 segmentio都属于 gitlab.luojilab.com/zeroteam/ddkafka模块，但是如果在 segmentio目录中加入了 go.mod，那么 segmentio 就不再隶属于 gitlab.luojilab.com/zeroteam/ddkafka模块。
 
  
那么依赖被下载到哪里了呢，你可以打开的目录 $GPATH/pkg/mod就可以看到了。
 
  
主模块和构建列表
 
  
The main module and the build list 暂且翻译为主模块和构建列表。
“主模块” 是包含运行 go 命令的目录的模块。 go 命令通过查找当前目录中的 go.mod 或者当前目录的父目录，或者祖父目录，依次递归查找。
 
  
go.mod 文件可以通过 require，replace 和 exclude 语句使用的精确软件包集。
 
  
    
   
  • require 语句指定的依赖项模块
    • 
   
  • replace 语句可以替换依赖项模块
    • 
   
  • exclude 语句可以忽略依赖项模块
    • 
  
 
  
go list，可以查看当前的依赖和版本.
 
  
 
  
    
   
  1. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka/segmentio (module)
    2. 
   
  2. $ ls  # 这是模块的子目录
    3. 
   
  3. segmention_Consumer.go  segmention_consumer_test.go  segmention_producer.go  segmention_producter_test.go
    4. 
   
    5. 
   
  5. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka/segmentio (module)
    6. 
   
  6. $ go list -m #主模块的打印路径
    7. 
   
  7. gitlab.luojilab.com/zeroteam/ddkafka
    8. 
   
  8. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka/segmentio (module)
    9. 
   
  9. $ go list -m -f={
       {.Dir}} #print主模块的根目录
    10. 
   
  10. D:\code\gopath\src\gitlab.luojilab.com\zeroteam\ddkafka
    11. 
   
  11. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka/segmentio (module)
    12. 
   
  12. $ go list -m all # 查看当前的依赖和版本信息
    13. 
   
  13. gitlab.luojilab.com/zeroteam/ddkafka
    14. 
   
  14. github.com/golang/glog v0.0.0-20160126235308-23def4e6c14b
    15. 
   
  15. github.com/segmentio/kafka-go v0.0.0-20180716203113-48c37f796910
    16. 
  
 
  
go mod 命令
 
  
go mod命令之前可以使用过了 go mod init，下面我们把常用的 go mod命令罗列一下：
 
  
    
   
  • go mod init: 初始化 modules
    • 
   
  • go mod download: 下载 modules 到本地 cache
    • 
   
  • go mod edit: 编辑 go.mod 文件，选项有 - json、-require 和 - exclude，可以使用帮助 go help mod edit
    • 
   
  • go mod graph: 以文本模式打印模块需求图
    • 
   
  • go mod tidy: 删除错误或者不使用的 modules
    • 
   
  • go mod vendor: 生成 vendor 目录
    • 
   
  • go mod verify: 验证依赖是否正确
    • 
   
  • go mod why：查找依赖
    • 
  
 
  
 
  
    
   
  1. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka (module)
    2. 
   
  2. $ go mod edit -json
    3. 
   
  3. {
       
    4. 
   
  4.         "Module": {
       
    5. 
   
  5.                 "Path": "gitlab.luojilab.com/zeroteam/ddkafka"
    6. 
   
  6.         },
    7. 
   
  7.         "Require": [
    8. 
   
  8.                 {
       
    9. 
   
  9.                         "Path": "github.com/golang/glog",
    10. 
   
  10.                         "Version": "v0.0.0-20160126235308-23def4e6c14b"
    11. 
   
  11.                 },
    12. 
   
  12.                 {
       
    13. 
   
  13.                         "Path": "github.com/segmentio/kafka-go",
    14. 
   
  14.                         "Version": "v0.0.0-20180716203113-48c37f796910"
    15. 
   
  15.                 }
    16. 
   
  16.         ],
    17. 
   
  17.         "Exclude": null,
    18. 
   
  18.         "Replace": null
    19. 
   
  19. }
    20. 
   
  20. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka (module)
    21. 
   
  21. $ cat go.mod
    22. 
   
  22. module gitlab.luojilab.com/zeroteam/ddkafka
    23. 
   
    24. 
   
  24. require (
    25. 
   
  25.         github.com/golang/glog v0.0.0-20160126235308-23def4e6c14b
    26. 
   
  26.         github.com/segmentio/kafka-go v0.0.0-20180716203113-48c37f796910
    27. 
   
  27. )
    28. 
   
    29. 
   
  29. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka (module)
    30. 
   
  30. $ go mod edit -require=github.com/Shopify/sarama@master
    31. 
   
    32. 
   
  32. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka (module)
    33. 
   
  33. $ cat go.mod
    34. 
   
  34. module gitlab.luojilab.com/zeroteam/ddkafka
    35. 
   
    36. 
   
  36. require (
    37. 
   
  37.         github.com/Shopify/sarama master
    38. 
   
  38.         github.com/golang/glog v0.0.0-20160126235308-23def4e6c14b
    39. 
   
  39.         github.com/segmentio/kafka-go v0.0.0-20180716203113-48c37f796910
    40. 
   
  40. )
    41. 
   
  41. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka (module)
    42. 
   
  42. $ go mod vendor  # 启动verdon
    43. 
   
  43. go: downloading github.com/Shopify/sarama v1.17.1-0.20180820172058-647feef69a1a
    44. 
   
  44. go: finding github.com/davecgh/go-spew/spew latest
    45. 
   
  45. go: finding github.com/eapache/queue v1.1.0
    46. 
   
  46. go: finding github.com/eapache/go-xerial-snappy latest
    47. 
   
  47. go: finding github.com/eapache/go-resiliency/breaker latest
    48. 
   
  48. go: finding github.com/rcrowley/go-metrics latest
    49. 
   
  49. go: downloading github.com/rcrowley/go-metrics v0.0.0-20180503174638-e2704e165165
    50. 
   
  50. go: finding github.com/bsm/sarama-cluster v2.1.15+incompatible
    51. 
   
  51. go: downloading github.com/eapache/go-xerial-snappy v0.0.0-20180814174437-776d5712da21
    52. 
   
  52. go: downloading github.com/bsm/sarama-cluster v2.1.15+incompatible
    53. 
   
  53. go: downloading github.com/eapache/queue v1.1.0
    54. 
   
  54. go: finding github.com/eapache/go-resiliency v1.1.0
    55. 
   
  55. go: downloading github.com/eapache/go-resiliency v1.1.0
    56. 
   
  56. go: finding github.com/davecgh/go-spew v1.1.1
    57. 
   
  57. go: downloading github.com/davecgh/go-spew v1.1.1
    58. 
   
  58. go: finding github.com/pierrec/lz4 v2.0.3+incompatible
    59. 
   
  59. go: downloading github.com/pierrec/lz4 v2.0.3+incompatible
    60. 
   
  60. go: finding github.com/golang/snappy latest
    61. 
   
  61. go: downloading github.com/golang/snappy v0.0.0-20180518054509-2e65f85255db
    62. 
   
    63. 
   
  63. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka (module)
    64. 
   
  64. $ ls
    65. 
   
  65. README.md  go.mod  go.sum  models.go  mq_interface.go  sarama  segmentio  vendor
    66. 
   
  66. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka (module)
    67. 
   
  67. $ go mod verify
    68. 
   
  68. all modules verified
    69. 
   
  69. qiang@DESKTOP-2A835P9 MINGW64 /d/code/gopath/src/gitlab.luojilab.com/zeroteam/ddkafka (module)
    70. 
   
  70. $ go mod why
    71. 
   
  71. go: finding github.com/onsi/ginkgo/extensions/table latest
    72. 
   
  72. go: finding github.com/onsi/ginkgo v1.6.0
    73. 
   
  73. go: finding github.com/Shopify/toxiproxy/client latest
    74. 
   
  74. go: finding github.com/onsi/gomega v1.4.1
    75. 
   
  75. go: downloading github.com/onsi/gomega v1.4.1
    76. 
   
  76. go: downloading github.com/onsi/ginkgo v1.6.0
    77. 
   
  77. go: finding github.com/onsi/ginkgo/extensions latest
    78. 
   
  78. go: finding github.com/Shopify/toxiproxy v2.1.3+incompatible
    79. 
   
  79. go: downloading github.com/Shopify/toxiproxy v2.1.3+incompatible
    80. 
   
  80. go: finding github.com/hpcloud/tail v1.0.0
    81. 
   
  81. go: finding github.com/golang/protobuf/proto latest
    82. 
   
  82. go: finding gopkg.in/yaml.v2 v2.2.1
    83. 
   
  83. go: downloading github.com/hpcloud/tail v1.0.0
    84. 
   
  84. go: downloading gopkg.in/yaml.v2 v2.2.1
    85. 
   
  85. go: finding github.com/golang/protobuf v1.2.0
    86. 
   
  86. go: downloading github.com/golang/protobuf v1.2.0
    87. 
   
  87. go: finding gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405
    88. 
   
  88. go: downloading gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405
    89. 
   
  89. go: finding gopkg.in/tomb.v1 latest
    90. 
   
  90. go: finding gopkg.in/fsnotify.v1 v1.4.7
    91. 
   
  91. go: downloading gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7
    92. 
   
  92. go: downloading gopkg.in/fsnotify.v1 v1.4.7
    93. 
   
  93. go: finding github.com/fsnotify/fsnotify v1.4.7
    94. 
   
  94. go: downloading github.com/fsnotify/fsnotify v1.4.7
    95. 
   
  95. # gitlab.luojilab.com/zeroteam/ddkafka
    96. 
   
  96. gitlab.luojilab.com/zeroteam/ddkafka
    97. 
  
 
  
go 的 mod 与 get
 
  
go get 这个命令大家应该不会陌生，这是下载 go 依赖包的根据，下载 Go 1.11 出来了，go get 命令也与时俱进，支持了 modules。
go get 来更新 module:
 
  
    
   
  • 运行 go get -u 将会升级到最新的次要版本或者修订版本
    • 
   
  • 运行 go get -u=patch 将会升级到最新的修订版本（比如说，将会升级到 1.0.1 版本，但不会升级到 1.1.0 版本）
    • 
   
  • 运行 go get package@version 将会升级到指定的版本号
    • 
  
 
  
运行 go get 如果有版本的更改，那么 go.mod 文件也会更改。
 
  
最后
 
  
最后说明一下最新出来的特性不建议立即使用到线上，最好再等等，等迭代一两个版本之后，得带最佳实践出来之后，毕竟现在支持 modules 模式的类库还真不多。
 
  
附录
 
  
    
   
  • https://tip.golang.org/cmd/go/#hdr-Modulesmoduleversionsandmore
    • 
   
  • https://roberto.selbach.ca/intro-to-go-modules
    • 
  
 
  

 
 



                  

                  
                  
                  

                

                

              


			  
			

				
				
			


        
             

                
  相关解决方案

                
                

                  
                

              

               
            

            
            

              

                

                 	

				    
				    
                

              

            

            
            
            

          

          

        

        

      

      
      
      

     

         

         
         	代码迷 - 您身边的软件异常，代码异常，编程异常助手（发现，解决，分享）

         Copyright © 2009-2013 DAIMAMI.COM. All rights reserved.