Gradle中如何从版本目录获取依赖版本并传入任务配置？

场景背景 #

之前通过gradle.properties存储依赖版本，迁移到Gradle版本目录后，大部分流程正常，但配置gradle-jooq-plugin时遇到版本获取异常——该插件需要传入jOOQ库版本以匹配代码生成器版本。

原properties配置（Kotlin DSL） #

jooq {
    version = project.property("jooq_version") as String
}

初始版本目录配置（带_version后缀） #

[versions]
jooq_version = "3.19.4"
...
[libraries]
jooq = { module = "org.jooq:jooq", version.ref = "jooq_version" }

此时使用libs.versions.jooq_version.version可正常工作，IntelliJ自动补全也无问题。

修改后的版本目录配置（移除_version后缀） #

[versions]
jooq = "3.19.4"
...
[libraries]
jooq = { module = "org.jooq:jooq", version.ref = "jooq" }

出现以下异常行为：

• libs.versions.jooq.version编译报错，但IntelliJ无错误提示
• libs.versions.jooq、libs.versions.jooq.getVersion()均编译报错
• 仅libs.versions.jooq.asProvider().get()可正常运行，但IntelliJ提示“未解析引用”

问题解答 #

1. 从版本目录获取指定依赖版本的正确方式 #

官方推荐两种写法：

• 直接获取版本字符串（适合非懒加载场景）：

  jooq {
      version = libs.versions.jooq.get()
  }
  

• 传入Provider对象（符合Gradle懒加载最佳实践，若插件支持接收Provider类型参数）：

  jooq {
      version.set(libs.versions.jooq)
  }
  

版本目录生成的版本对象本质是Provider<String>，无需额外调用asProvider()，直接使用即可。

2. Gradle与IntelliJ的表现差异是否为Bug #

属于IntelliJ IDE层面的Bug。Gradle本身的编译逻辑能正确识别重名的版本与库对象，但IntelliJ的Gradle插件代码索引未处理好这种命名冲突场景，导致提示异常。可尝试刷新Gradle项目、重启IntelliJ缓解，若问题持续需等待IntelliJ修复兼容性问题。

3. 带_version后缀与移除后缀的行为差异原因 #

• 带_version后缀时：[versions]中的jooq_version与[libraries]中的jooq无重名，Gradle生成的libs.versions.jooq_version是单纯的Version对象，具备.version属性可直接获取版本字符串。
• 移除后缀后：[versions]与[libraries]均使用jooq作为名称，此时libs.versions.jooq是Provider<String>类型（而非Version对象），不再具备.version属性，因此调用.version会报错；同时IntelliJ的索引逻辑混淆了版本对象与库对象的类型，导致提示异常。

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