Gradle同步IntelliJ时子项目被移出父项目问题求助

针对你遇到的Gradle同步时父项目外生成带依赖缓存哈希的镜像副本、子项目被移至外部且修改文件同步变更的问题，分享几个我实际排查过的有效方向：

• 检查settings.gradle的项目路径配置
  这是最常见的原因之一。打开项目根目录的settings.gradle，仔细核对每个子项目的include和projectDir设置：

  • 确保没有错误地将子项目路径指向父项目外部，比如类似project(':service').projectDir = file('../service_main')的配置
  • 如果使用了动态路径生成（比如基于变量拼接路径），确认变量值没有意外指向外部目录

• 排查IntelliJ的Gradle导入与构建设置
  打开IntelliJ的「Settings/Preferences > Build, Execution, Deployment > Build Tools > Gradle」，检查这些选项：

  • 确认「Use Gradle from」选择的是项目本地的Gradle版本，避免全局Gradle配置带来的干扰
  • 尝试切换「Build and run using」为「Gradle」（而非IntelliJ IDEA），防止IDE的自动构建逻辑触发异常路径映射
  • 暂时关闭「Use auto-import」，手动执行Gradle同步，观察问题是否依然存在

• 彻底清理Gradle缓存与守护进程
  除了删除项目根目录的.gradle和.idea，还需要：

  • 删除用户目录下的Gradle全局缓存（比如~/.gradle/caches，Windows下是C:\Users\<你的用户名>\.gradle\caches）
  • 执行命令行：./gradlew clean（Windows用gradlew clean）清理项目构建产物，再执行./gradlew --stop停止所有Gradle守护进程，之后重新打开IDE同步Gradle

• 检查子项目的build.gradle配置
  查看service子项目的build.gradle，确认是否存在特殊配置：

  • 有没有自定义的输出路径、发布任务，或者引入的第三方插件（比如某些代码生成、缓存管理插件）自动创建了镜像项目
  • 如果用到了多模块构建的特殊插件，查阅插件文档看是否有禁用镜像生成的配置项

• 逐步排查配置项（二分法测试）
  如果以上步骤都无效，可以尝试创建一个全新的空项目，只复制核心的settings.gradle、根目录build.gradle和service子项目，逐步添加原项目的其他配置、插件、依赖，每添加一项就同步Gradle，观察问题何时重现，以此精准定位触发问题的配置。

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