IntelliJ IDEA与Gradle多项目依赖联动开发实现方法问询

问题背景 #

GitLab上存在两个项目：project-a 和 project-a-dependency。project-a 通过 implementation("my.space:project-a-dependency") 引入后者作为依赖。当前开发流程为修改project-a-dependency后打包上传至Nexus，再在project-a中拉取新版本依赖。希望改为在IntelliJ IDEA中同时打开两个项目，修改依赖后直接重建即可查看所有变更，但尝试操作后报错：

Project with path ':project-a' could not be found in root project 'project-a-dependency'

可行方案及操作步骤 #

完全可以实现本地联动开发，无需上传Nexus，具体操作如下：

1. 正确导入依赖项目为子模块 #

• 打开project-a的IntelliJ IDEA窗口
• 点击顶部菜单栏 File → New → Module from Existing Sources...
• 选中project-a-dependency项目的根目录，按提示完成导入（选择Gradle类型，保持默认配置即可）

2. 替换远程依赖为本地项目引用 #

在project-a的build.gradle（或build.gradle.kts）中，将远程依赖替换成本地模块：

// 注释或删除原远程依赖
// implementation("my.space:project-a-dependency")
// 替换为本地项目引用
implementation project(':project-a-dependency')

3. 解决报错问题 #

你之前出现报错的核心原因是误将project-a-dependency作为根项目打开，而非作为project-a的子模块导入。按步骤1的方式导入后，IDEA会以project-a作为根项目，project-a-dependency作为子模块存在，此时点击「Load Gradle Changes」就不会再出现找不到:project-a的错误。

4. 验证联动效果 #

• 修改project-a-dependency中的代码
• 在project-a中执行构建或运行操作，IDEA会自动使用本地修改后的依赖代码，无需上传Nexus

可选：使用Gradle复合构建（无需修改依赖声明） #

如果不想改动implementation依赖配置，可以在project-a的settings.gradle（或settings.gradle.kts）中添加复合构建配置：

includeBuild('../project-a-dependency')

添加后Gradle会自动优先使用本地的project-a-dependency项目替代远程依赖，实现联动开发。

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