如何在IntelliJ中以Gradle为构建系统关联两个项目/模块

方案一：将库项目作为本地模块导入 #

适合开发期间长期关联的场景，直接把库整合进应用项目的模块结构：

• 打开应用项目的IntelliJ，通过File > New > Module from Existing Sources...，选择库项目的根目录（包含build.gradle/build.gradle.kts的文件夹），导入时选择Gradle并保持默认配置。
• 检查应用项目的settings.gradle/settings.gradle.kts，确认已自动添加库模块的引用，若未自动添加则手动补充：
  Groovy DSL示例：

  include ':library-module'
  // 若库不在应用项目同级目录，需指定路径
  project(':library-module').projectDir = file('../path/to/your/library')
  

  Kotlin DSL示例：

  include(":library-module")
  project(":library-module").projectDir = file("../path/to/your/library")
  

• 在应用项目的build.gradle/build.gradle.kts中添加依赖：
  Groovy DSL：

  dependencies {
      implementation project(':library-module')
  }
  

  Kotlin DSL：

  dependencies {
      implementation(project(":library-module"))
  }
  

• 点击IntelliJ的Gradle同步按钮，之后应用项目即可直接调用库的代码，编译、运行时自动共享类路径，修改库代码后应用会实时感知。

方案二：Gradle复合构建（保持项目独立性） #

适合不想修改应用项目模块结构、希望两个项目仍保持独立仓库状态的场景：

• 在应用项目的settings.gradle/settings.gradle.kts中添加对库项目的构建引用：
  Groovy DSL示例：

  includeBuild '../path/to/your/library-project'
  

  Kotlin DSL示例：

  includeBuild("../path/to/your/library-project")
  

• 在应用项目的build.gradle/build.gradle.kts中，像依赖远程库一样添加库的坐标（需与库项目的groupId/artifactId/version完全一致）：
  Groovy DSL：

  dependencies {
      implementation 'com.your.group:library-artifact:1.0.0-SNAPSHOT'
  }
  

• 同步Gradle后，IntelliJ会自动关联两个项目，构建应用时会直接使用本地库的最新代码，无需发布到本地Maven仓库，且两个项目的修改会互相影响。

注意事项 #

• 尽量保证两个项目使用的Gradle版本一致，避免出现兼容性问题
• 复合构建模式下，两个项目仍可独立构建、提交代码，仅在应用构建时关联
• 模块导入模式下，库会作为应用项目的子模块显示在IntelliJ的项目结构中

内容的提问来源于stack exchange，提问作者jactor-rises