Gradle项目模块依赖失效：Maple游戏引擎双模块无法互相引用

这类问题90%的情况都是机制冲突：IntelliJ 对 Gradle 托管的模块、非 Gradle 管理的普通 Java 模块，走两套完全独立的类路径扫描逻辑。你之前手动在「项目结构-模块依赖」里加的双向关联，只要一执行Gradle同步，就会被Gradle的构建规则自动覆盖清空，根本无法生效。这也是为什么两个模块都做普通Java项目时能正常导入Display类，一旦把引擎模块转成Gradle项目就完全失联的本质原因。

方案1（推荐，一劳永逸）：把两个模块统一纳入同一套Gradle构建 #

全程根本不需要手动在IntelliJ的模块设置里点依赖，配完同步就能正常识别：

• 先把之前手动加的所有跨模块依赖全删掉，免得干扰Gradle的同步逻辑
• 在项目根目录的settings.gradle里，把引擎、Sandbox都声明为同级子模块，示例写法：

  rootProject.name = "MapleRoot"
  include ':maple-engine'
  include ':sandbox'
  

• 调整两个模块的目录结构符合Gradle默认规范，把原来引擎模块下写的Java源码，移动到maple-engine/src/main/java路径下，资源文件放到maple-engine/src/main/resources下，不然Gradle根本扫不到你写的类
• 在Sandbox模块的build.gradle里，加一行对引擎模块的项目依赖：

  plugins {
      id 'java'
  }
  dependencies {
      implementation project(':maple-engine')
  }
  

• 执行Gradle同步，等同步完成后IntelliJ会自动识别两个模块的依赖关系，这时候com.maple.Display就能正常导入，自动补全也会恢复正常。后续要引LWJGL3的依赖，直接在引擎模块的build.gradle里加就行，会自动传递到Sandbox的类路径里，不用两边重复配。

方案2（临时凑合用，不推荐长期维护）：保持Sandbox为普通Java项目 #

如果你就是不想把Sandbox改成Gradle项目，那就用打Jar的方式打通依赖，但是调试体验会很差：

• 先修正引擎模块的Gradle配置，确保源码目录能被Gradle正确识别，在引擎模块的build.gradle里加java-library插件
• 执行gradlew :maple-engine:build命令，生成引擎模块的可引用Jar，一般在maple-engine/build/libs/目录下
• 把生成的引擎Jar、还有引擎用到的所有LWJGL3相关Jar，作为外部依赖手动加到Sandbox的类路径里
• 缺点非常明显：每次改引擎模块的代码，都要重新打Jar包同步到Sandbox里，调试的时候断点、热替换都不好用，适合临时应急不适合长期开发。

• 别配双向依赖：Java的模块逻辑本来就不该是两个模块互相依赖，这样会形成循环依赖，就算临时配通了，后续打包的时候也会出类路径冲突的问题。正常的依赖关系就是「Sandbox 单向依赖 引擎模块」就行，引擎完全不需要知道Sandbox的存在
• 别被IntelliJ的自动补全误导：当Gradle同步状态异常、类路径扫错的时候，哪怕你类的路径完全正确，自动补全也不会弹出导入提示，手动敲全类名也会标红，这种情况优先检查Gradle是不是同步失败了，不是你类放错了位置
• 转Gradle的时候一定要核对目录结构：很多人把普通Java项目转成Gradle的时候，忘了按照Gradle的要求把源码放到src/main/java下面，导致Gradle根本识别不到你写的Display类，就算依赖配置写对了也导不进来

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