使用Gradle约定插件替代根目录apply from文件的原因及性能对比

选用Gradle约定插件的核心原因 #

• 更强的跨项目复用性：约定插件可封装成独立模块或JAR，能直接在多项目甚至多代码仓库间复用通用配置（编译参数、依赖管理、插件逻辑等）。而根目录apply的通用文件仅能在当前项目内部复用，跨项目需复制脚本或依赖子模块，维护成本高且易出现配置不一致。
• 更简洁的项目结构：子项目的build.gradle只需声明应用约定插件，无需重复编写通用配置，大幅降低子项目配置复杂度，避免根目录通用文件因逻辑堆积变得臃肿混乱。
• 更可控的版本管理：约定插件可作为独立组件做版本控制，不同版本可适配不同Gradle或依赖版本。项目切换配置仅需修改插件版本号，而根目录apply文件的版本调整需逐个修改内部配置项，易出错。
• 类型安全的配置体验：用Kotlin/Groovy编写的约定插件支持类型安全DSL，编写时即可发现配置错误；而根目录的Groovy脚本类通用文件，多数错误要到构建执行阶段才会暴露。
• 灵活的定制扩展：约定插件可提供扩展属性或方法，子项目能在通用约定基础上做定制化调整，同时不破坏整体配置的统一性；而根目录apply文件的定制化通常依赖大量if-else判断，逻辑越复杂越难维护。

执行速度对比 #

二者的执行速度差异极小，可忽略不计。Gradle配置阶段的核心是解析配置逻辑，无论是apply根目录的通用文件还是应用约定插件，本质都是加载执行配置代码。

唯一的例外是：若约定插件为远程依赖的JAR，首次使用时需下载插件包，会有短暂等待；但后续构建会缓存插件，速度就和本地apply文件一致。如果是项目内buildSrc模块形式的本地约定插件，速度与根目录apply文件基本无区别。

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