在Gradle中声明模块依赖时使用mapOf有何优势？

两种写法的本质关联 #

implementation(project(":core:domain"))是Gradle KTS提供的语法糖，底层会自动将字符串路径转换为mapOf("path" to ":core:domain")的形式，最终调用的是同一个接受map参数的project()方法重载。

Map写法的核心优势 #

• 支持扩展配置项：除了必填的path，还能指定额外参数。比如需要依赖模块的特定构建配置而非默认的default配置时，可以这么写：

  implementation(project(mapOf(
      "path" to ":core:domain",
      "configuration" to "debugRuntimeElements"
  )))
  

  这在多环境构建、拆分不同变体依赖的场景下很实用。
• 适配动态配置场景：如果依赖路径或配置是动态生成的（比如从变量、外部配置读取），map写法能更灵活地组装参数：

  val targetModule = getTargetModule() // 动态获取模块路径
  val targetConfig = getTargetConfig() // 动态获取配置项
  implementation(project(mapOf("path" to targetModule, "configuration" to targetConfig)))
  

• 兼容历史脚本：这种map形式是早期Groovy脚本的标准写法，KTS保留该重载是为了兼容跨语言脚本的迁移场景。

Gradle 8.0中的使用建议 #

日常开发用短写法implementation(project(":core:domain"))就足够，简洁直观。只有当你需要自定义依赖配置或者动态生成依赖参数时，再考虑使用map写法。Gradle 8.0对两种写法的支持都很完善，不存在兼容性问题。

内容的提问来源于stack exchange，提问作者eqtöck