多子项目Gradle工程中根级build.gradle是否为可选文件？

结论先行 #

根级build.gradle（或build.gradle.kts）完全是可选的，Gradle并不强制要求多项目构建必须包含这个文件。

为什么gradle init不生成根build.gradle？ #

当你通过gradle init创建多子项目Java工程时，默认场景下假设每个子项目可以独立配置，没有需要全局共享的构建逻辑，所以Gradle不会自动生成根级构建文件。此时Gradle仅依靠settings.gradle（或settings.gradle.kts）中声明的子项目列表来识别项目结构，直接执行各子项目自身的构建配置。

手动创建后为什么会被执行？ #

只要根目录存在build.gradle文件，Gradle在启动构建时会自动加载并执行其中的代码。这个文件的核心作用是定义所有子项目共享的构建逻辑，比如：

• 统一为所有子项目应用Java插件
• 配置全局依赖仓库（如Maven Central）
• 定义跨子项目的通用任务（比如一次性打包所有子项目、合并测试报告）
• 统一管理依赖版本（比如通过platform插件或版本 catalog）

什么时候需要添加根级build.gradle？ #

只有当你需要在子项目之间复用构建配置时，才需要创建这个文件：

• 所有子项目使用相同的JDK版本、编译参数
• 多个子项目依赖相同的第三方库，需要统一版本
• 需要执行跨子项目的构建操作

如果你的子项目彼此完全独立，没有任何共享的构建规则，那么完全可以不用创建根级build.gradle，Gradle依然能正常处理每个子项目的构建任务。

注意：settings.gradle是必须的 #

无论是否有根级构建文件，多项目构建都必须包含settings.gradle（或settings.gradle.kts）——它是Gradle识别子项目结构的核心文件，用来声明哪些目录属于当前构建的子项目。

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