根项目无Gradle构建文件时allprojects{}的作用及配置位置

1. allprojects{}的作用 #

allprojects{}块的核心作用是为当前构建中的所有项目（包括配置该块的项目本身及其所有层级的子项目）统一应用通用配置。比如统一设置仓库地址、通用依赖版本、代码风格规则或公共插件，用这个块能避免在每个项目里重复编写相同配置，实现配置的集中管理。

2. 该块应配置在哪个文件中？ #

按照Gradle官方推荐的「根项目仅含settings.gradle」结构，你需要在根项目下创建build.gradle（或build.gradle.kts）文件，将allprojects{}块放在这里。只有根项目的构建脚本能覆盖整个构建树的所有项目——根项目作为所有子项目的顶层父节点，其配置会传递到所有层级的子项目中。

如果根项目没有build.gradle，则无法通过allprojects{}统一配置所有项目，只能改用subprojects{}或在各子项目单独配置，但会失去集中管理的便利性。

3. 是否只有包含子子项目的子项目才会用到它？ #

完全不是。不管子项目有没有自己的子项目，只要你需要给所有项目（包括根项目、一级子项目、二级子子项目等）统一配置，就可以使用allprojects{}。哪怕你的多项目只有根项目+几个一级子项目，没有更深层级的子项目，用它来统一配置仓库、公共插件依然能提升效率。

4. 子项目构建文件中的allprojects{}为什么没用？ #

如果把allprojects{}放在某个子项目的build.gradle里，它的作用范围仅限于该子项目本身及其自己的子项目，无法覆盖其他同级子项目或根项目。这种情况下，它的效果和subprojects{}（仅作用于当前项目的子项目）加上当前项目自身配置几乎一致，完全起不到「统一所有项目」的作用，因此没有实用价值。

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