Gradle如何在settings.gradle.kts访问buildSrc构建配置属性

原有可用实现 #

基于buildSrc实现构建profile属性读取的逻辑在项目级构建脚本中可正常运行，实现步骤为：

1. 在buildSrc目录下定义属性读取类Versions：

class Versions(properties: Map<String, *>) {
  // 属性读取逻辑
}

2. 在模块build.gradle.kts中传入项目属性实例化类，即可正常读取配置：

val vs = Versions(project.properties)

报错原因 #

在settings.gradle.kts中沿用相同逻辑，传入settings.properties实例化Versions类时会抛出引用找不到的错误：

val vs = Versions(settings.properties)

报错输出：

e: /home/peng/git/shapesafe/settings.gradle.kts:2:10: Unresolved reference: Versions

该问题不是类路径配置错误导致：buildSrc是Gradle约定的项目级构建目录，它的代码编译、类生成时机在settings.gradle.kts求值完成之后，settings脚本运行阶段buildSrc的代码还未进入编译流程，自然无法引用其中定义的类。

解决方法 #

方法1：抽离独立构建逻辑模块（通用推荐） #

将公共构建配置类从buildSrc迁移到独立的预编译included build模块，绕开构建生命周期的顺序限制：

• 在项目根目录新建build-logic目录（名称可自定义），把原buildSrc下的Versions类、其他公共构建逻辑全部迁移到该目录，为目录配置基础的Kotlin编译依赖即可
• 在settings.gradle.kts最顶部优先引入该构建逻辑模块：

pluginManagement {
    includeBuild("build-logic")
}

• 配置完成后，即可在settings.gradle.kts中正常实例化Versions类读取配置，所有子模块的build.gradle.kts也能正常访问该模块内的公共类，使用体验和原buildSrc一致，同时支持更灵活的构建逻辑拆分。

方法2：简单逻辑内联（适配小型项目） #

如果属性读取逻辑非常简单，不需要复用大量构建代码，可以直接在settings.gradle.kts中内联编写属性读取逻辑，不依赖buildSrc内的类。该方案存在少量代码重复，仅适合构建逻辑简单的小型项目。

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