go mod tidy导入本地包时出现模块路径重复读取报错

路径重复拼接的本质是模块定义、导入路径、replace 规则三者完全不匹配，Go 工具链未命中本地替换规则，按照默认远程拉取逻辑错误拼接了路径。

具体错配逻辑 #

• 模块定义与预期导入路径不对齐
  a 目录下的 go.mod 声明模块名为 A，但业务代码中使用的导入路径是 github.com/x/y/src/a/b，二者无映射关系。Go 模块解析规则规定：如果 require 的模块没有命中 replace 规则，会默认按模块路径+版本号从远程拉取代码，拉取时按照标准 VCS 结构拼接 go.mod 读取路径，最终生成了重复拼接的 github.com/x/y/src/a/b/src/a/b/go.mod 异常路径。
• replace 规则与 b 模块的实际模块名不匹配
  b 目录下的 go.mod 声明模块名是 module a/b，但 a 包的 go.mod 中 require 的模块路径是 github.com/x/y/src/a/b，两个字符串完全不一致，导致写好的 replace github.com/x/y/src/a/b => ./b 规则完全失效，没有触发本地路径替换逻辑。
• 模块层级的规则认知偏差
  Go 1.13 引入的模块系统中，不存在“同目录下的子文件夹自动归属父模块”的隐式逻辑：只要子目录下存在独立的 go.mod 文件，它就是完全独立的模块，必须靠模块路径的严格字符串匹配才能被正确导入。

可直接执行的修复方案 #

按照以下配置调整后，路径重复拼接问题会直接解决：

1. 修改 a 目录下的 go.mod
   • 将模块名替换为和预期导入路径一致的完整标识，不要使用短名 A：

     module github.com/x/y/src/a
     go 1.13
     

   • 保留本地路径替换规则，确保替换的源路径和 require 路径完全一致：

     replace (
         github.com/x/y/src/a/b => ./b
     )
     require (
         github.com/x/y/src/a/b v0.0.0
     )
     

2. 修改 b 目录下的 go.mod
   将模块名调整为和 require 路径完全匹配的字符串，不要使用短路径 a/b：

   module github.com/x/y/src/a/b
   go 1.13
   require golang.org/x/sys v0.0.0-20210124154548-22da62e12c0c
   

3. 校验 a.go 中的导入语句
   确保导入路径和模块路径完全对齐，不需要额外拼接 a.go 的文件名后缀，即直接写：

   import b "github.com/x/y/src/a/b"
   

补充：异常拼接路径的生成逻辑
当 replace 规则完全失效时，Go 工具链会把 github.com/x/y/src/a/b@v0.0.0 判定为需要从远程拉取的版本化模块，按照 VCS 模块的版本路径解析规则，自动将模块路径与版本标识对应的路径后缀重复拼接，最终生成了 github.com/x/y/src/a/b/src/a/b/go.mod 这类无效拉取路径，触发 unknown revision 的报错。

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