Gradle Kotlin约定插件中libs版本目录无法访问的问题

使用Gradle 8.8 + Kotlin，项目结构如下：

root
|
\ **buildSrc**
   |
   \src/main/kotlin/**build.test-conventions.gradle.kts**
   |
   \ build.gradle.kts
   \ settings.gradle.kts
\ gradle
   |
   \ wrapper
   \ **libs.versions.toml**
...

在gradle/libs.versions.toml中定义版本与依赖：

[versions]
test-version=1.0.0

[libraries]
some-lib = { module = "..", version.ref="test-version" }
...

根目录settings.gradle.kts已配置版本目录：

dependencyResolutionManagement {
  versionCatalogs {
    create("libs") {
      from(files("../gradle/libs.versions.toml"))
    }
  }
}

遇到的问题：在build.test-conventions.gradle.kts中使用implementation(libs.some.lib)时，提示libs不可用；但buildSrc/build.gradle.kts中libs可正常使用，改用Groovy实现约定插件时libs也可用。

已尝试的操作：

• 在根目录settings.gradle.kts中添加dependencyResolutionManagement配置
• 改用Groovy实现约定插件

预期结果：buildSrc下kotlin目录中的所有约定插件均可使用libs语法引用依赖。

问题原因 #

buildSrc是独立的Gradle子项目，它的构建流程由自身的settings.gradle.kts和build.gradle.kts控制，根目录的dependencyResolutionManagement配置不会作用于buildSrc内部的预编译Kotlin脚本插件（即.gradle.kts格式的约定插件）。

具体细节：

1. Kotlin预编译脚本插件需要在buildSrc构建阶段生成类型安全的libs访问器，这要求buildSrc自己的settings.gradle.kts中必须配置版本目录，否则编译约定插件时无法识别libs。
2. buildSrc/build.gradle.kts能正常使用libs，是因为它是buildSrc项目自身的构建脚本，会默认继承buildSrc项目的依赖解析配置。
3. Groovy约定插件是动态脚本，不需要提前生成类型安全访问器，能直接复用buildSrc项目中已加载的版本目录配置，因此可以正常访问libs。

解决方案 #

步骤1：配置buildSrc的settings.gradle.kts #

在buildSrc/settings.gradle.kts中添加版本目录配置，指向根目录的libs.versions.toml：

dependencyResolutionManagement {
    versionCatalogs {
        create("libs") {
            from(files("../gradle/libs.versions.toml"))
        }
    }
}

步骤2：确保buildSrc启用Kotlin DSL插件 #

在buildSrc/build.gradle.kts中应用kotlin-dsl插件，确保Gradle能为版本目录生成类型安全访问器：

plugins {
    `kotlin-dsl`
}

repositories {
    mavenCentral()
}

完成上述配置后重新同步项目，buildSrc下的Kotlin约定插件就能正常使用libs.some.lib这类语法引用依赖了。

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