how go.mod works?

Posted 2022-11-24 15:31 +0800 by ZhangJie ‐ 1 min read

分享:  

go.mod/go.sum内容

go.mod里面包含的信息包括:

  • 当前module构建要求的最小go版本
  • 依赖的module及校验和信息
  • 为了方便本地开发测试的一些replace信息

这里不讨论vendor相关的modules.txt中的内容。

最小go版本号

我们举个例子来描述下。

  • 如果当前module的go.mod是go 1.16,等价于编译的时候go build -gcflags ‘-lang=1.16’ / go tool compile -lang=1.16。

  • 假设我们现在安装的go版本是go1.19。

这种情况下执行编译测试:

  • 如果我们用了范型(go1.18开始支持),go编译器编译时会检查, 本来go1.19肯定能编译1.18的范型代码,但是它会报错出来,因为go.mod里声明的go版本,是当前项目支持的最小go版本,有可能别人不是1.19而是1.15,1.17,所以要报错提示下

    我们还没有用那些1.16.5以后的新特性非得要新版本的go来编,所以之前能正常编。

  • 如果我们安装的go1.15,go.mod里面的1.16高了,也会先尝试编译,编过了就编过了,编不过就报错最小版本是1.16.5 比如机器上现在是1.19,可以go.mod改成1.20正常编过

  • 如果因为-lang编译导致的编不过,如果go.mod里面的版本比当前安装的版本高,还会打印出来 module requires go 1.21,提示安装新版本

依赖信息

依赖的module,除了指明importPath,还要指明version,才能完整指明一个依赖。这个应该没什么疑问,所以大家都会提交go.mod文件。

再说下校验和,有什么用呢?防止包内容被篡改。有些同学因为什么原因导致校验和经常冲突,需要解决冲突,所以直接不提交go.sum文件了,这是十分错误的。

有同学可能会觉得这些繁琐的步骤很荒唐,其实并不是,可重复的制品构建,是一门非常重要的工程上的保证手段,为了达到此目的,甚至还有封闭构建、构建容器等其他方法来提供进一步的保证。

本文小结

本文简单记录了下go.mod/go.sum相关的知识点,可能对刚接触这块的同学比较有价值 :)