本地Go项目跨项目导入失败：无法找到提供project2包的模块

我之前也碰到过几乎一模一样的情况，核心问题在于Go的模块系统是基于模块路径而非本地项目名称工作的——你直接写import "project2"时，Go会默认尝试从远程代码仓库拉取这个模块，但你的project2是本地项目，所以必须明确告诉Go它的本地路径才行。下面是一步步的解决方法：

第一步：确认project2的模块定义 #

首先进入你的project2目录，查看它的go.mod文件第一行的module指令，执行：

cat project2/go.mod

你会得到类似这样的结果：

module github.com/yourname/project2

这里的github.com/yourname/project2就是project2的模块路径，后续导入和配置都要用到这个路径，而不是直接用project2。

第二步：在project1的go.mod中添加replace指令 #

Go的replace指令可以让模块系统把某个远程模块路径映射到本地目录。假设你的两个项目目录结构是这样的：

~/workspace/
├── project1/
│   └── go.mod
└── project2/
    ├── go.mod
    └── engine/

那么进入project1目录，编辑它的go.mod文件，添加一行：

replace github.com/yourname/project2 => ../project2

如果是绝对路径也可以，比如：

replace github.com/yourname/project2 => /Users/yourname/workspace/project2

第三步：正确导入project2的engine包 #

在project1的代码里，要使用project2的模块路径来导入engine包，而不是直接写project2/engine：

import (
    "github.com/yourname/project2/engine"
)

第四步：同步依赖 #

最后在project1目录下执行依赖同步命令：

go mod tidy

这时候Go会正确识别本地的project2模块，Goland的跳转和代码提示也会正常工作了。

为什么之前的方法没用？ #

• 直接写import "project2"：Go模块系统会认为这是一个远程模块，尝试去拉取，但它只存在本地，所以报错。
• 复制到vendor目录：vendor目录里的包路径必须和导入路径完全匹配，你直接复制project2进去的话，路径还是project2/engine，和Go期望的模块路径不匹配，所以还是找不到。

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