Gradle Kotlin DSL：如何在plugins块中调用Versions常量？

问题原因 #

Gradle的plugins块是特殊的预编译上下文，类加载时机早于项目其他代码，所以无法直接引用项目里自定义的Versions类，这就是块外能调用、块内报错的核心原因。

方案1：用gradle.properties配合extra属性（简单直接） #

1. 在项目根目录的gradle.properties里定义版本常量：

springBootVersion=2.7.10

2. 在build.gradle.kts中两种使用方式：

// 方式一：绑定到extra，全项目通用
val springBootVersion: String by project.extra

plugins {
    // 直接读取gradle.properties的属性
    id("org.springframework.boot") version "${property("springBootVersion")}"
}

// 块外也能使用extra里的属性
println(springBootVersion)

方案2：用buildSrc预编译脚本插件（保留类结构） #

如果想继续用Versions.kt的集中管理结构，把它放到buildSrc目录（Gradle会优先编译这个目录的代码，供plugins块调用）：

1. 创建目录结构：buildSrc/src/main/kotlin/org/kopi/galite/gradle/，把你的Versions.kt放进去：

package org.kopi.galite.gradle

object Versions {
    const val SPRING_BOOT = "2.7.10"
}

2. 给buildSrc加个简单的build.gradle.kts（如果Versions.kt不需要额外依赖，也可以省略）：

plugins {
    `kotlin-dsl`
}

repositories {
    mavenCentral()
}

3. 现在build.gradle.kts的plugins块就能直接引用了：

plugins {
    id("org.springframework.boot") version Versions.SPRING_BOOT
}

// 块外同样正常使用
println(Versions.SPRING_BOOT)

方案3：用Gradle版本目录（7.0+推荐） #

Gradle7.0支持版本目录功能，适合复杂项目的版本管理：

1. 在项目根目录创建gradle/libs.versions.toml：

[versions]
springBoot = "2.7.10"

[plugins]
spring-boot = { id = "org.springframework.boot", version.ref = "springBoot" }

2. 在build.gradle.kts中使用：

plugins {
    alias(libs.plugins.spring.boot)
}

这种方式无需自定义类，Gradle自动解析配置，还支持跨项目共享版本。

内容的提问来源于stack exchange，提问作者Mohamed Aziz Tousli