Gradle不支持自动发现嵌套模块，必须在settings.gradle中逐级显式include每个子项目路径，如sub1/basesub111/three111需写三行include语句，漏掉任一层将报路径找不到错误。
Gradle 本身不支持“自动发现”多层嵌套模块，必须显式声明每个子项目路径，否则 gradle build 会直接报错找不到项目。
settings.gradle 里必须逐级 include 每个嵌套层级
Gradle 的 include 不是递归扫描目录，而是按字符串路径注册子项目。比如你有结构：sub1/basesub111/three111，就必须写三行：
include 'sub1'include 'sub1:basesub111'include 'sub1:basesub111:three111'
漏掉中间一层（比如只写 sub1 和 sub1:basesub111:three111），Gradle 就会在解析时抛出 Project with path ':sub1:basesub111:three111' could not be found。IDEA 创建模块时容易自动生成错误路径，务必手动核对 settings.gradle 中的每一行是否与磁盘目录完全对应。
projectDir 映射错位会导致构建失败或依赖失效
当嵌套模块不在标准相对路径下（比如 sub1/basesub111 实际放在 modules/core-lib），就得用 project(':sub1:basesub111').projectDir = new File("$rootDir/modules/core-lib") 显式重定向。但注意两点：
- 路径必须是绝对路径（
new File(...)或"$rootDir/..." as File），字符串不行 -
projectDir设置必须在include之后，否则 Gradle 会忽略 - 如果多个模块映射到同一目录，会触发
Duplicate project name冲突
子模块 build.gradle 里引用深层模块要写全路径
假设 sub2 想依赖 sub1:basesub111:three111，它的 build.gradle 必须写：
dependencies {
implementation project(':sub1:basesub111:three111')
}
不能简写成 project(':three111') 或 project('three111') —— Gradle 不做名称模糊匹配。另外，如果该模块用了 java-library 插件，还要确认暴露方式：用 api 才能让依赖链穿透三层，用 implementation 会导致 sub2 编译通过但运行时报 NoClassDefFoundError。
IDEA 刷新后仍显示灰色模块？检查 .idea/modules.xml
即使 settings.gradle 正确，IDEA 有时会缓存旧路径。此时需：
- 关闭项目，删掉
.idea目录和所有*.iml文件 - 重新用 IDEA 打开根目录（不是子模块目录）
- 等待 Gradle 同步完成，别点 “Import project from external model”
- 同步完若仍有模块未识别，手动执行
gradle projects验证命令行是否能列出全部嵌套项目
最常被忽略的是：嵌套模块的 build.gradle 文件必须存在且语法合法，哪怕只是空文件。Gradle 在解析 settings.gradle 后，会对每个 include 路径下的 build.gradle 做静态检查——缺文件或语法错误，整个构建就卡在初始化阶段。
