全部配置 / KN-XXDEBUG-LEVEL-COMPILER-CHECKS

XXdebug-level-compiler-checks

XXdebug-level-compiler-checks · KN-XXDEBUG-LEVEL-COMPILER-CHECKS · 编译器参数(Native)

重要:低 · 工具/诊断 默认:默认关 场合:排障诊断 来源:上游原样

默认值:默认关。false(BooleanType.defaultFalse)。使用场合:排障诊断。编译器内部调试。

它是做什么的

用途。启用调试级编译器检查(可能显著变慢)。原文:Enable debug level compiler checks.

影响。内部调试开关;勿用于应用工程常规配置。

适用场景。编译器内部调试;应用工程不要打开。

取值说明

布尔 · 写法 -XXdebug-level-compiler-checks(开启) · 默认 false(BooleanType.defaultFalse)

  • 参数描述:Enable debug level compiler checks. ATTENTION: these checks can slow compiler down or even crash it.

可写。(开关存在 / true) / false / 不传

定义依据:description/CommonCompilerArguments.kt 在仓库中打开

怎么用

  1. 配置入口:build.gradle.kts → ohosArm64.binaries.all { freeCompilerArgs += "-XXdebug-level-compiler-checks" }
  2. 示例
// 文件:build.gradle.kts(应用的 Kotlin 模块,例如 composeApp)
kotlin {
  ohosArm64 {  // 按实际 native target 调整
    binaries.all {
      freeCompilerArgs += "-XXdebug-level-compiler-checks"
    }
  }
}
  1. 生效:Sync 后执行该目标的 compile/link。
  2. 验证:编译日志出现 `-XXdebug-level-compiler-checks`。
  3. 回滚:从 binaries.all 的 freeCompilerArgs 中删除该项后 Clean 并重编。
  4. 注意:内部开关,行为无稳定承诺;勿用于应用发布配置。

默认行为 默认关

不写这个配置时,编译器会怎么处理?

此选项默认关闭,不设置时不生效。需要时显式开启。

false(BooleanType.defaultFalse)。

溯源与对照

状态
内部(-XX,更不稳定)
版本基线
2.2.21-1.0.0
定义位置类型
编译器参数定义(arguments DSL)
源码路径
compiler/arguments/src/org/jetbrains/kotlin/arguments/description/CommonCompilerArguments.kt 在仓库中打开