全部配置 / APP-LANGUAGEVERSION

语言版本

languageVersion · APP-LANGUAGEVERSION · Gradle DSL · 同源入口 language-version

重要：高 · 影响大默认：视情况（按目标/构建类型）场合：场景可配来源：上游原样

默认值：视情况。未设则跟工具链语言默认走。使用场合：场景可配。场景可配：有明确目标（性能、包体、安全、兼容）时再改。

它是做什么的

用途。按指定 Kotlin 语言版本提供源码兼容（语法与语言语义）。用于锁定语言能力、控制迁移节奏。

影响。锁定语言/API 能力边界；设错会导致源码无法编译或误用新 API。

适用场景。编译器/后端排查或信息查询；定位完成后关闭冗余输出。

字符串

Provide source compatibility with the specified version of Kotlin. Possible values: "1.8 (deprecated)", "1.9 (deprecated)", "2.0", "2.1", "2.2", "2.3 (experimental)", "2.4 (experimental)", "2.5 (experimental)" Default value: null

可写。<属性值> （Gradle Property：org.gradle.api.provider.Property<org.jetbrains.kotlin.gradle.dsl.KotlinVersion>）

定义依据：dsl/KotlinCommonCompilerOptions.kt 在仓库中打开

// 文件：build.gradle.kts（应用的 Kotlin 模块，例如 composeApp）
kotlin {
  compilerOptions {
    languageVersion.set(/* value */)
  }
}

应用工程只按上方「怎么用」里的 Gradle 示例配置。下面列出编译器还认识的旧名字，避免对着旧文档混用。

优先级：Gradle DSL 与 CLI 配置的是同一语言版本旋钮；工程里优先用 compilerOptions。

推荐旗标：compilerOptions.languageVersion（键 languageVersion） — Gradle DSL（compilerOptions）。
旧旗标（勿用）：-language-version <version>（键 language-version） — 旧编译器旗标；应用工程用本页推荐的 compilerOptions，不要再写一条 freeCompilerArgs。

不写这个配置时，编译器会怎么处理？

此选项的默认值视情况而定（如目标平台或构建类型）。详见下方默认值说明。

未设则跟工具链语言默认走。

状态: 稳定（正式选项）
版本基线: 2.2.21-1.0.0
定义位置类型: Gradle 插件 API（compilerOptions）
源码路径: libraries/tools/kotlin-gradle-plugin-api/src/common/kotlin/org/jetbrains/kotlin/gradle/dsl/KotlinCommonCompilerOptions.kt 在仓库中打开