当前位置：首页 > news >正文

【Kotlin】const 修饰的编译期常量

news 2025/7/31 21:42:40

const 修饰的是编译期常量（compile-time constants），即编译器在编译时就能确定其值的常量。这类常量需要满足：

类型必须是基本类型（Int、Double 等）或 String
必须在编译时就能确定值（不能是运行时计算的结果）

以下是对 const 修饰的编译期常量三种存在场景的总结：

1. 顶层（文件级）常量

场景：直接定义在 Kotlin 文件的类外部，属于包级作用域，全局可见。

Kotlin 写法（文件名：AppConstants.kt）：

package com.example// 顶层 const 常量
const val API_BASE_URL = "https://api.example.com"
const val MAX_RETRY_COUNT = 3

等效 Java 代码：

package com.example;public final class AppConstantsKt {  // 类名由文件名 + "Kt" 构成public static final String API_BASE_URL = "https://api.example.com";public static final int MAX_RETRY_COUNT = 3;
}

特点：

编译后生成独立的 Java 类（文件名 + “Kt”）。
常量被声明为 public static final，可直接通过类名访问（如 AppConstantsKt.API_BASE_URL）。

2. 伴生对象（companion object）内部常量

场景：定义在类的伴生对象中，属于类的静态成员，与类强关联。

Kotlin 写法：

package com.exampleclass NetworkConfig {// 伴生对象中的 const 常量companion object {const val TIMEOUT_MS = 5000const val ENABLE_SSL = true}
}

等效 Java 代码：

package com.example;public final class NetworkConfig {public static final int TIMEOUT_MS = 5000;public static final boolean ENABLE_SSL = true;// 伴生对象相关代码（无需手动使用）public static final NetworkConfig.Companion Companion = new NetworkConfig.Companion();public static final class Companion {}
}

特点：

常量直接成为外部类的 public static final 成员。
可通过类名直接访问（如 NetworkConfig.TIMEOUT_MS）。

3. 单例类（object 声明）内部常量

场景：定义在 object 声明的单例类中，属于单例的静态成员（单例本身全局唯一）。

Kotlin 写法：

package com.example// 单例类
object AppConfig {// 单例类中的 const 常量const val APP_VERSION = "1.0.0"const val IS_DEBUG = false
}

等效 Java 代码：

package com.example;public final class AppConfig {public static final AppConfig INSTANCE = new AppConfig();  // 单例实例public static final String APP_VERSION = "1.0.0";public static final boolean IS_DEBUG = false;private AppConfig() {}  // 私有构造函数，确保单例
}