IntelliJ IDEA不显示Gradle多项目子项目，疑与文件夹命名带点相关

首先明确问题根因：

• IDEA 本身不会独立识别 Gradle 项目的子模块，所有模块展示完全依赖 Gradle 同步后返回的项目模型；你当前的场景下，两个子项目目录均位于根目录下、且名称自带点号，Gradle 默认既不会自动扫描纳入项目体系，还会因为路径里的点符号误判模块层级关系，最终导致同步后模型缺失、IDE 无法正常显示子项目。

必做配置修正 #

1. 补全根目录 settings.gradle 的映射配置 #

没有在 settings.gradle 里显式声明的目录，永远不会被 Gradle 识别为子项目；尤其是带点号的根级目录，直接写 include ':hub.common_service' 会被 Gradle 识别为嵌套三层项目（根项目下挂hub模块，hub模块下再挂common_service子模块），和实际平级的目录结构完全错配。
正确写法：

// 根目录 settings.gradle 完整配置
rootProject.name = 'omega-root'

// 显式声明两个子项目的逻辑路径ID和物理磁盘目录的映射关系，绕开点号的层级解析
include ':common-service'
project(':common-service').projectDir = file('./hub.common_service')

include ':sample-service'
project(':sample-service').projectDir = file('./hub.sample_service')

2. 修正根目录 build.gradle 的关联配置 #

你原配置里的项目引用名要和上面声明的逻辑路径ID保持一致，同时替换已废弃的compile依赖配置：

// 原配置中项目依赖块修正
project(':sample-service') {
    dependencies {
        // 替换原已废弃的 compile 配置
        implementation project(':common-service')
    }
}

• 额外注意：公共依赖模块不需要套Spring Boot可执行插件。你当前在subprojects代码块里全局应用了org.springframework.boot插件，会让作为公共库的hub.common_service生成可执行Jar而非普通依赖Jar，进一步导致IDEA把模块识别错误。针对公共模块做单独配置：

project(':common-service') {
    // 注释掉不适用的Boot插件
    // apply plugin: 'org.springframework.boot'
    apply plugin: 'java-library'
}

IDEA 侧同步操作 #

配置修改完成后按顺序操作：

• 打开右侧Gradle工具窗口，点击刷新按钮执行全量项目同步
• 若同步后仍有模块显示异常，打开 File -> Project Structure -> Modules，删除所有残留的错误模块配置后，重新执行一次Gradle全量同步
• 校验模块的源码路径关联：确认每个子模块下的src/main/java被标记为源码目录、src/main/resources被标记为资源目录，标记丢失的话手动右键目录调整对应属性即可

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