导入Gradle多项目时IntelliJ IDEA未自动分配文件夹类别问题

• IDEA侧Gradle导入规则的核心配置缺失
  • 未指定匹配版本的Gradle执行JVM：IDEA2019.2.2默认会用自带的JetBrains Runtime解析Gradle脚本，这个运行时的版本和Spring Framework构建脚本要求的JDK版本不匹配，会导致Gradle同步阶段静默跳过sourceSet目录的识别逻辑，仅拉取模块列表、不解析源码目录映射关系。需在Gradle导入设置页，将Gradle JVM选项从默认内置运行时，手动修改为本地安装的、符合Spring Framework版本要求的JDK（如Spring 5.x对应JDK1.8）。
  • 未开启Gradle构建委托开关：IDEA2019.2的Gradle同步默认会优先把项目目录识别为普通文件夹，只有开启Delegate IDE build/run actions to Gradle选项，同步时才会直接读取Gradle脚本内定义的sourceSet规则，自动将对应目录标记为源码、测试、资源类型，从根源上避免手动标记后刷新失效的问题。
• 项目根目录的本地适配配置缺失
  • gradle.properties文件未固定JDK执行路径：需在该文件内补充org.gradle.java.home配置，直接指定本地符合版本要求的JDK安装路径，避免Gradle在多次同步时动态识别JDK失败，导致sourceSet规则解析中断。
  • 未补充老版本IDEA适配的Gradle插件配置：IDEA2019.2对新版Gradle生成的工程元数据兼容度不足，需在根目录build.gradle中补充idea插件的适配规则，明确目录映射关系：

    idea {
      module {
        downloadSources = true
        // 补充生成源码目录的识别规则
        generatedSourceDirs += file("$buildDir/generated/sources")
      }
    }
    

• 容易被忽略的版本兼容配置冲突
  • 拉取的代码分支版本与IDEA版本不匹配：IDEA2019.2.2内置的Gradle插件最高仅能兼容Gradle 6.x版本，如果直接拉取Spring Framework主分支代码，其默认自带的Gradle 7+版本的wrapper会因为语法不兼容，导致同步过程在无报错的情况下跳过所有目录映射逻辑，仅生成无源码关联的空模块。需切换到与IDEA2019.2适配的Spring Framework 5.2.x release分支，匹配对应Gradle 5.6版本的wrapper配置。
  • 未清理旧的本地工程元数据：之前手动标记的目录属性都存储在项目根目录的.idea文件夹、各模块下的.iml文件中，只要重新执行Gradle同步，检测到旧元数据和脚本规则不匹配，就会直接清空所有手动设置的目录标记。同步前需完全删除上述目录和文件，再执行一次全量Gradle同步。

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