若有任何问题或建议，欢迎及时交流和碰撞。我的公众号是 【脑子进煎鱼了】，GitHub 地址：https://github.com/eddycjy。

大家好，我是煎鱼。

前几天 Go 官方正式发布了 1.16 版本。从这个版本起，环境变量 GO111MODULE 的默认值正式修改为 on。

image.png

这也意味着 Go modules 将更进一步推进其业务覆盖面，有新老项目共存的小伙伴建议手动将 GO111MODULE 调整为 auto。

Go1.16 针对 Go modules 放出了一个新特性，能够让维护 Go mod 库的开发者拥有反复吃 “后悔药” 的权力，提醒开发者已发布的 “脏” 版本存在问题。

这个新特性，对于许多维护和使用公共库（开源、企业等）的小伙伴简直是一个小福音，建议大家都应该要了解这个知识点。

在接下来文章中将进行详细说明和介绍。

后悔药：Go mod retract

retract

在使用场景上：在发现严重问题或无意发布某些版本后，模块的维护作者可以撤回该版本，支持撤回单个或多个版本。

以前没有办法解决，因此一旦出现就非常麻烦。对应两者的操作如下：

  • 维护者：

    • 删除有问题版本的 tag。
    • 重新打一个新版本的 tag。

  • 使用者：

    • 发现有问题的版本 tag 丢失，需手动介入。
    • 不知道有问题，由于其他库依赖，因此被动升级而踩坑。

因此在本次 Go1.16 发布后，就拥有了一个半止损的新手段了，也可以作为 Go mod 自动更新的大坑的补全办法之一。

实战演练

为了方便演示，首先创建一个 Demo 项目（github.com/eddycjy/go-retract-demo），其含有一个基础方法：

package go_retract_demo

func HelloWorld() string {
    return "001：脑子进煎鱼了！"
}

另外有一个应用工程依赖了该第三方库，代码如下：

func main() {
  // import demo "github.com/eddycjy/go-retract-demo"
    s := demo.HelloWorld()
    fmt.Println(s)
}

对应的 go.mod 文件如下：

module github.com/eddycjy/awesomeProject

go 1.16

require github.com/eddycjy/go-retract-demo v0.0.1

retract 特性演示

eddycjy/go-retract-demov0.3.0v0.2.0
v0.3.0go.modretract
module github.com/eddycjy/go-retract-demo

go 1.16

// 因为煎鱼不小心敲错了...
retract v0.2.0

指令上面为撤回的原因，后面是具体的版本。如果涉及多版本，可以如下编写：

retract (
  v0.1.0
  v0.2.0
)

retract 特性效果

v0.3.0retractgo list
$ go1.16 list -m -u all
github.com/eddycjy/awesomeProject
github.com/eddycjy/go-retract-demo v0.2.0 (retracted) [v0.3.0]
go list
go getwarning
$ go1.16 get github.com/eddycjy/go-retract-demo@v0.2.0
go: warning: github.com/eddycjy/go-retract-demo@v0.2.0: retracted by module author: 因为煎鱼不小心敲错了...
go: to switch to the latest unretracted version, run:
    go get github.com/eddycjy/go-retract-demo@latest

这样就能看到是哪个模块依赖，因为什么原因要求撤回了，非常直观。

总结

以往在出问题后每个个体需要跑去问维护者或者看 GitHub Commits，那样总归非常麻烦，很可能一来一回半个钟就没了。

新特性给予了 Go modules 软撤回版本的一个方法，能够把问题更直观的反馈到开发者的手中，再结合日常开发工具的话更是美哉。

但这个特性的完全应用目前也是有一定的阻碍的：

  • 国内模块代理：需要国内的模块代理也支持 retract ，否则即使你更新了版本也没有提示处理。
  • IDE：IDE 针对 retract 做一些支持，例如：文字颜色标红、黄等，能够便于开发者更好的识别。

你对 Go modules 的 retract 特性怎么看，欢迎一起留言讨论！

我的公众号

分享 Go 语言、微服务架构和奇怪的系统设计，欢迎大家关注我的公众号和我进行交流和沟通。

最好的关系是互相成就，各位的点赞就是煎鱼创作的最大动力，感谢支持。