Golang 遇到 note module requires Go 1.nn 解决之道,不升go

遇到note: module requires Go 1.17,或者 note: module requires Go 1.18 等报错该如何是好呢?可能你会搜索到很多升级Go版本的答案。有没有想过揪出到底是哪个包导致了升级呢?有不用升级Go版本的办法,想试试么?

在使用多版本的golang的小伙伴,往往会遇到这个问题。本文就如何不升级 go 版本来解决该问题。

怎么产生的

  1. 同时使用IDE和命令行,命令行go版本和IDE的go不是同一个版本。
  2. 多人协作同一个项目,别人使用不同版本的go加入了一个包且写入了一个较高版本号。
  3. go get 时选择了较高版本。

网上的大部分解决方案都是升级自己的go版本。那么如果不想升级有办法解决么?

不升Go版本

例如我遇到了:

# golang.org/x/sys/unix
../../go/pkg/mod/golang.org/x/sys@v0.3.0/unix/syscall.go:83:16: undefined: unsafe.Slice
../../go/pkg/mod/golang.org/x/sys@v0.3.0/unix/syscall_darwin.go:95:8: undefined: unsafe.Slice
../../go/pkg/mod/golang.org/x/sys@v0.3.0/unix/syscall_unix.go:118:7: undefined: unsafe.Slice
../../go/pkg/mod/golang.org/x/sys@v0.3.0/unix/sysvshm_unix.go:33:7: undefined: unsafe.Slice
note: module requires Go 1.17

尝试把 go.sum 删掉,再 go mod tidy 还是没用,依然报这个错。

这时看看 go.mod 文件

module github.com/PaulXu-cn/xxx

go 1.15

require (
    github.com/go-faker/faker/v4 v4.0.0-beta.4
    github.com/golang/protobuf v1.5.2
    github.com/snksoft/crc v1.1.0
    github.com/spf13/cobra v1.6.1
    github.com/spf13/viper v1.15.0
)

也就是说当前我的 go runtime1.15 的,
是引用了基于 go1.17 的包,需要把这个包降为依赖 go1.15的即可。那这里的哪个包需要降版本呢?

该项目简单,只有5个直接依赖,可以通过依次删除添加测出来,如果有很多依赖的话,又该怎么解决呢?

包后面带 // indirect 是间接依赖,删掉这一行不影响。
参考 https://go.dev/ref/mod

上工具

这里介绍个工具 gmchartgo mod 图像化展示工具 —— https://github.com/PaulXu-cn/go-mod-graph-chart

进入工作项目

cd goProejct

安装 gmchart

$ go install github.com/PaulXu-cn/go-mod-graph-chart/gmchart@latest

运行

$ go mod graph | gmchart
go mod graph version v0.5.3
the go mod graph will top in 60s
visit it by http://127.0.0.1:59760

go mod graph 是官方工具命令。 可展示出了该项目所有的依赖关系,只不过是文本形式展示,输出的内容多了,人眼看不出啥来。这里借用 gmchart 工具,可以将其依赖关系组织为 树状 渲染 web 页面,也就是和go 工具一样,跨平台的。

利用工具找问题

回到我们刚刚的报错啊, golang.org/x/sys 包依赖了 go1.17.

这里我们搜一下啊

search1

呦,一共有84个,我们再把版本号输入进去,缩小范围

search2

好的,定位到了1个,那就是它了,然后呢?

看了看 go.mod , 好像我们也没有直接引用它,要去 go.mod 删也没有得删。

如果是如下情况,带有 indirect 注释的,删除了也不能解决问题!

require(
    golang.org/x/sys v0.3.0 // indirect
)

这里有大聪明,建议我去 go.sum 里面去删,这是没用的哈,go mod tidy 一下又回来了。

找出直接依赖

  1. 用工具找到具体包
  2. 在界面中点击包
  3. 查看所有引入了该包的 包。这里我们看到了5个包,viper这个包是直接依赖,因此该调整这个包的版本

search_gif

serach_gif_mark

  1. 在 github 上找到 viper https://github.com/spf13/viper
  2. 打开 go.mod —— https://github.com/spf13/viper/blob/master/go.mod

viper_master

这里通过查看 vipergo.mod ,发现最新的 viper 已是基于 go1.17 , 我的项目 go get 了最新版本的 viper,所以,编译时就会报错——note: module requires Go 1.17

这里按理说不会拉取高版本的 viper,但这里是切换了go版本,导致了该情况。

  1. 项目要求是不高于 go1.15,那就依次便利 viper 的各个tag。好——viper@1.9.0 是当前版本最高且要求不高于 go1.15 的。https://github.com/spf13/viper/blob/v1.9.0/go.mod

  1. 把项目中 go.mod, 依赖—— viper 版本改为 v1.9.0 报错就解决了。

总结

我最近在做项目时,切换 go 版本遇到了该问题,顺手查了下,发现网上的答案都是让其升级 go 版本,其实就是依赖高版本的第三方包,这里借用工具,找出该包,通过降第三方包的方式也能解决该问题。

如果大家遇到同类问题,不想升go版本,可以试试改方案。

没有遇到也没关系,收藏一下,某天遇到了不想升go可以再翻出来看看

qrcode

参考

  • https://go.dev/ref/mod
  • https://github.com/PaulXu-cn/go-mod-graph-chart