Golang 遇到 note: module requires Go 1.xx 解决之道,不升 go
在使用多版本的 golang 的小伙伴,往往会遇到这个问题。本文就如何不升级 go 版本来解决该问题。
怎么产生的
- 同时使用 IDE 和命令行,命令行 go 版本和 IDE 的 go 不是同一个版本。
- 多人协作同一个项目,别人使用不同版本的 go 加入了一个包且写入了一个较高版本号。
- 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 runtime 是 1.15 的,
是引用了基于 go1.17 的包,需要把这个包降为依赖 go1.15 的即可。那这里的哪个包需要降版本呢?
该项目简单,只有 5 个直接依赖,可以通过依次删除添加测出来,如果有很多依赖的话,又该怎么解决呢?
包后面带 //indirect 是间接依赖,删掉这一行不影响。
参考 go.dev/ref/mod
上工具
这里介绍个工具 gmchart , go 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.
这里我们搜一下啊
呦,一下 84 个,我们再把版本号输入进去,缩小范围
好的,定位到了 1 个,那就是它了,然后呢?
看了看 go.mod , 好像我们也没有直接引用它,要去 go.mod 删也没有得删。
如果是如下情况,带有 indirect 注释的,删除了也不能解决问题!
require(
golang.org/x/sys v0.3.0 // indirect
)
这里有大聪明,建议我去 go.sum 里面去删,这是没用的哈,go mod tidy 一下又回来了。
找出直接依赖
- 用工具找到具体包
- 在界面中点击包
- 查看所有引入了该包的 包。这里我们看到了 5 个包,viper 这个包是直接依赖,因此该调整这个包的版本
- 在 github 上找到 viper https://github.com/spf13/viper
- 打开 go.mod —— https://github.com/spf13/viper/blob/master/go.mod
这里通过查看 viper 的 go.mod ,发现最新的 viper 已是基于 go1.17 , 我的项目 go get 了最新版本的 viper,所以,编译是就会报错 ——note: module requires Go 1.17
这里按理说不会拉取高版本的 viper,但这里是切换了 go 版本,导致了该情况。
- 项目要求是不高于 go1.15,那就依次便利 viper 的各个 tag。好 ——viper@1.9.0 是当前版本最高且要求不高于 go1.15 的。
- 把项目中 go.mod, 依赖 —— viper 版本改为 v1.9.0 报错就解决了。
总结
我最近在做项目时,切换 go 版本遇到了该问题,顺手查了下,发现网上的答案都时让其升级 go 版本,其实就是依赖高版本的第三方包,这里借用工具,找出该包,通过降第三方包的方式也能解决该问题。
如果大家遇到同类问题,不想升 go 版本,可以试试改方案。
没有遇到也没关系,收藏一下,某天遇到了不想升 go 可以再翻出来看看