Go module 如何发布 v2 及以上版本？
用上 Go module 之后，发布的版本都在 v1 上面，用了这么长时间遇到了升级 v2 版本的问题。记录一下。
用上 go mod 之后，依赖包都是通过版本打 tag 的形式确定版本号。比如 ` github.com/mnhkahn/gogogo v1.0.9`。每次都改动都是在累加低位的版本号，一直这么用也挺安逸的。突然有一天，我的一个底层包需要大改，导致和之前的版本彻底不兼容，这种情况下如何设置版本号，如何能让调用方成功接入？
Go module 版本号
先讲一下 Go 在用的版本号协议semver (Semantic Versioning)。它定义的版本号格式是：
vMAJOR.MINOR.PATCH
- MAJOR 主版本号，如果有大的版本更新，导致 API 和之前版本不兼容。我们遇到的就是这个问题。
- MINOR 次版本号，当你做了向下兼容的新 feature。
- PATCH 修订版本号，当你做了向下兼容的修复 bug fix。
- v 所有版本号都是 v 开头。
比如我们用的 Go 语言，目前是 1.12.0。它还是 Go 1，每次升级都保证是兼容的，12的版本号是新 feature，而最末尾的版本号是修复。说明当前的版本上了之后还没有修复过问题。
我这次也是搞了一个不兼容的更新，所以需要升级到 v2.0.0。
Go 项目如何升级 v2？
假设你的项目已经支持 go module 了。
- 修改 go.mod 第一行，在
module那行最后加上/v2。module github.com/mnhkahn/aaa/v2。 - 对于不兼容的改动（除了 v0 和 v1），都必须显示得修改 import 的路径。所以我们的引用需要改成
import "github.com/mnhkahn/aaa/v2/config"。在所有的地方都需要修改，包括自己的包内和调用方包。 - 底层包的更新有个小工具可以帮助快速实现mod。
GO111MODULE=on go get github.com/marwan-at-work/mod/cmd/modmod upgrade。 - 代码提交之后需要打新 tag，v2.0.0。
- 调用方修改引用代码，需要加
v2，和第二步提到的一样。 go get github.com/mnhkahn/aaa/v2。
incompatible
有时候你能在 go.mod 文件中发现不兼容的标记，v3.2.1+incompatible，这是因为这个依赖包没有使用 go module，并且它通过 git 打了 tag。
v0.0.0-20190312205133-abcdefghijklm
对于没有打 tag 的仓库，go.mod 就会很丑陋，它的格式是pseudo-version。它的含义是v0.0.0-yyyymmddhhmmss-abcdefabcdef。
tag 删除了重建为什么没效果？
困扰了我很久的一个问题。有一个 tag v2.0.0 的代码有问题，我删除了这个 tag，新建了一个好的版本，但是go get依然报错，困扰了很久，一直以为是 v2 的版本号写错了。后来才发现是 go 有本地缓存，缓存在 $GOPATH/pkg/mod/cache 下面，把里面的内容清掉，重新获取即可。
更多阅读：Go 1.11 Modules。
原文链接：Go module 如何发布 v2 及以上版本？，转载请注明来源！
–EOF–