【报错解决-Golang】go mod 替换第三方包提示：module declares its path as: ××× but was required as: ×××

错误信息

在对项目中的一个第三方模块进行版本升级（kingpin从 2.2.6升级到2.3.2）的时候，出现以下报错：

# go mod tidy
go: finding module for package gopkg.in/alecthomas/kingpin.v2
go: found gopkg.in/alecthomas/kingpin.v2 in gopkg.in/alecthomas/kingpin.v2 v2.3.2
go: pocscan imports
        gopkg.in/alecthomas/kingpin.v2: gopkg.in/alecthomas/kingpin.v2@v2.3.2: parsing go.mod:
        module declares its path as: github.com/alecthomas/kingpin/v2
                but was required as: gopkg.in/alecthomas/kingpin.v2

搜遍全网，说啥的都有，但都解决不了我的问题，随即自行分析排查，最终找到原因。

错误原因

需要先修改隐藏在代码文件的模块引用（require）：

import (
	"fmt"
	"os"
	"os/signal"
	"path/filepath"

	// 修改前这里是 gopkg.in/alecthomas/kingpin.v2
	"github.com/alecthomas/kingpin/v2"
)

然后再执行下面的操作即可：

go mod tidy
// 或
go get github.com/alecthomas/kingpin/v2

作个记录，希望对读者有用！