Gradle多模块项目依赖配置核心是settings.gradle的include路径与build.gradle中project(':xxx')依赖声明严格一致，路径用冒号分隔、大小写敏感，且必须匹配实际目录结构。
直接用 settings.gradle 声明子模块，再配好各模块的 build.gradle，就能跑通。不需要 Maven 那套 parent/pom.xml 概念，Gradle 的父子关系纯靠文件路径 + include 定义。
settings.gradle 里必须写对 include 路径
这是最常出错的地方：名字和实际目录不一致，或者用了斜杠/反斜杠混写。
-
include 'core'表示子模块在./core/目录下，不是./src/core或./modules/core - 如果子模块在嵌套目录里，比如
modules/core，就得写include 'modules:core'（冒号分隔，不是斜杠） - 多个模块可以一行写：
include 'core', 'web', 'service' - 别漏掉根项目的
rootProject.name，尤其当目录名和项目名不同时，IDE 可能识别错
根项目的 build.gradle 用 subprojects 统一基础配置
避免每个子模块都重复写 JDK 版本、仓库、编码等——这些属于构建基础设施，不该分散在各处。
- Java 项目常用配置可放这里：
sourceCompatibility = JavaVersion.VERSION_1_8、repositories { mavenCentral() }、tasks.withType(JavaCompile) { options.encoding = 'UTF-8' } - Spring Boot 项目慎用
subprojects加spring-boot-gradle-plugin：这个插件只该在最终可执行模块（如:web）里 apply，否则会触发错误的打包逻辑 - 依赖版本统一管理推荐用
ext块或versionCatalogs（Gradle 8.2+），而不是在每个build.gradle里硬写'org.springframework:spring-core:5.3.31'
模块间依赖必须用 project(':xxx')，不能写成坐标
这是和 Maven 最根本的区别：项目内模块引用走的是 Gradle 的项目路径，不是 Maven 坐标。写错就会编译失败，报 Could not resolve project ':core' 这类错误。
- 假设你有
web模块依赖core模块，在web/build.gradle里写：implementation project(':core') - 路径必须和
settings.gradle里的include完全一致，包括大小写和冒号层级 - 不要试图用
implementation 'com.example:core:1.0'替代——那是发布到 Maven 仓库后的写法，本地多模块开发阶段无效 - 如果依赖的是另一个模块的测试代码（比如要复用 test utils），得用
testImplementation project(path: ':core', configuration: 'testArtifacts')，默认不导出 test 产物
IDEA 刷新后看不到子模块？检查 .idea/misc.xml 和 Gradle 插件状态
不是 Gradle 配置错了，而是 IDEA 没同步过来。常见于从 Maven 迁移或手动建目录后直接刷新。
- 先关掉项目，删掉
.idea目录和.gradle目录，再重新用 IDEA 打开根目录 - 确保 IDEA 的 Gradle 插件已启用（Settings → Plugins → 搜索 Gradle）
- 右键根项目 → “Reload project”，不是点右上角 Gradle 工具窗里的刷新按钮
- 如果子模块 build.gradle 里用了 Kotlin DSL（
build.gradle.kts），但 IDEA 没装 Kotlin 插件，也会显示为普通文件夹，不会识别成模块
真正麻烦的从来不是怎么写配置，而是路径名、冒号层级、IDE 缓存这三样东西咬在一起时，错误信息根本不告诉你哪边错了。建议每加一个模块，立刻执行 gradle projects 看输出树形结构是否符合预期——比等编译失败后再排查快得多。
