Go依赖替换报错：go.uber.org/mock对应两个模块路径

我有一个规模较大的Go项目，依赖于github.com/golang/mock。但该包已停止维护，开发者指引用户使用其分支go.uber.org/mock。因此我希望将github.com/golang/mock依赖替换为go.uber.org/mock。

我尝试用go.mod的replace指令来实现（无需修改所有文件的导入路径），在go.mod中添加了如下内容：

replace github.com/golang/mock => go.uber.org/mock v0.2.0

但执行go mod tidy等Go命令时出现错误：

$ go mod tidy
...
go: go.uber.org/mock@v0.2.0 used for two different module paths (github.com/golang/mock and go.uber.org/mock)

错误的核心是：go.uber.org/mock@v0.2.0本身的模块声明路径就是go.uber.org/mock，而你通过replace指令强制让github.com/golang/mock也指向这个版本，这就导致Go模块系统发现同一个模块版本被映射到两个不同的模块路径，违反了模块唯一性的约束。

方法一：全局替换导入路径（推荐） #

由于go.uber.org/mock是独立的新模块，和原模块路径不兼容，最稳妥的方式是批量修改项目中所有的导入语句：
在项目根目录执行以下命令（适配macOS/Linux）：

find . -name "*.go" -type f -exec sed -i '' 's/github.com\/golang\/mock/go.uber.org\/mock/g' {} +

执行完后运行go mod tidy，Go会自动更新依赖，移除旧的github.com/golang/mock并添加go.uber.org/mock。

方法二：排查并移除重复依赖（仅适用于特定场景） #

如果项目中存在直接或间接引入go.uber.org/mock的代码或依赖，需要先将这些引用移除，再尝试使用replace指令。但这种方式容易遗漏隐藏依赖，不推荐用于大规模项目。

内容的提问来源于stack exchange，提问作者Jordan Barrett