Kotlin Value Class 全面解析：类型安全与零开销封装

在日常开发中，我们经常会遇到这样的场景：

用户 ID、订单 ID、商品 ID 本质上都是字符串（String），却代表完全不同的业务含义。
如果直接用 String 传递，编译器不会帮我们检查，容易把 OrderId 错传到 UserId 的函数中。
为了避免这种错误，我们需要一种既类型安全，又没有运行时开销的方式来封装这些值。
在 Kotlin 中，这正是 value class 存在的意义。

什么是 Value Class？

Value Class（值类）是 Kotlin 1.5 引入的正式特性，用 @JvmInline value class 定义。

它的本质是：

在 编译期，它是一个独立的类型（提供类型安全）；
在 运行时，它会被编译器优化为其内部包装的值（零开销）。

换句话说：

value class 是类型安全的轻量级封装，本质上就是"没有运行时开销的包装类"

定义 Value Class

一个最简单的 value class 示例：

kotlin 复制代码

@JvmInline
value class UserId(val id: String)

fun printUser(userId: UserId) {
    println("UserId = ${userId.id}")
}

fun main() {
    val id = UserId("123")
    printUser(id) // ✅ 正确
    // printUser("123") // ❌ 编译错误，类型不匹配
}

运行时 UserId("123") 和 "123" 没有区别，但编译器会强制检查类型，避免误用。

为什么要用 Value Class？

假设有两个不同的 ID 类型：

kotlin 复制代码

@JvmInline value class UserId(val id: String)
@JvmInline value class OrderId(val id: String)

如果直接用 String：

kotlin 复制代码

fun printUser(userId: String) { ... }
fun printOrder(orderId: String) { ... }

编译器不会阻止你传错参数：

kotlin 复制代码

printUser("order-100") // ❌ 合法，但语义错误

但使用 value class：

kotlin 复制代码

fun printUser(userId: UserId) { ... }
fun printOrder(orderId: OrderId) { ... }

printUser(OrderId("100")) // ❌ 编译错误

这样，编译器就能帮助我们避免业务逻辑错误。

Value Class 的特点

✅ 类型安全

不同的 value class 即使内部包装同一种类型（比如 String），也互不兼容。

✅ 零开销

在大多数场景下，编译器会把 value class 内联展开为底层值，没有对象分配。

✅ 支持运算符重载

可以为 value class 添加运算符，例如 <、>、+、-。

kotlin 复制代码

@JvmInline
value class VipLevel(val level: Int) {
    operator fun compareTo(other: VipLevel): Int = level - other.level
}

fun main() {
    val basic = VipLevel(0)
    val premium = VipLevel(2)

    println(basic < premium)  // true
}

✅ 可以实现接口

value class 不能继承类，但可以实现接口。

kotlin 复制代码

interface JsonConvertible {
    fun toJson(): String
}

@JvmInline
value class UserId(val id: String) : JsonConvertible {
    override fun toJson(): String = "\"$id\""
}

使用限制

只能有一个属性
构造函数参数只能有一个。

kotlin 复制代码

@JvmInline
value class Point(val x: Int, val y: Int) // ❌ 错误

不能有 init 块

因为它在运行时可能没有对象，无法初始化。
不能继承类

但可以实现接口。
可能装箱

在某些情况下（比如泛型、反射）value class 仍然会被装箱成普通对象。

应用场景

业务 ID 封装

用户 ID、订单 ID、商品 ID 等。
单位化数值

用 value class 表示 Meters、Seconds，避免误传不同单位。
领域模型建模

比如封装 Email、PhoneNumber，提高代码可读性和安全性。

Value Class 与 Java 互操作性

在 JVM 平台上，Kotlin 的 value class 会被编译成一个普通的 Java 类，并且包含内部属性的 getter。

因此在 Java 代码中使用 Kotlin 的 value class 时，需要特别注意以下几点：

Java 看到的是普通类

例如 Kotlin 中的定义：

kotlin 复制代码

@JvmInline
value class UserId(val id: String)

在 Java 中会被编译为：

java 复制代码

public final class UserId {
    @NotNull
    private final String id;

    @NotNull
    public String getId() {
        return id;
    }

    // equals(), hashCode(), toString() 会自动生成
}

也就是说，在 Java 里它就是一个不可变的普通类。

因此在 Java 中必须显式构造：

java 复制代码

UserId id = new UserId("123"); // Java 视角

内联优化只在 Kotlin 内部有效

在 Kotlin 中，UserId("123") 在运行时会被优化为底层的 String，不会创建对象。

但在 Java 调用时，它始终是一个真正的 UserId 对象。

也就是说：

Kotlin ↔ Kotlin：零开销
Kotlin ↔ Java：正常对象

泛型场景下可能退化为对象

即使在 Kotlin 内部，如果涉及到泛型，value class 也可能会被装箱成对象。

kotlin 复制代码

fun <T> identity(x: T): T = x

val userId = UserId("123")
val same = identity(userId) // 在这里可能装箱

这意味着在与 Java 混用时，更容易遇到装箱。

与 Java 交互的建议

如果要与 Java 频繁交互，建议谨慎使用 value class，避免额外的对象创建
如果 value class 主要在 Kotlin 内部使用，则完全可以放心使用
在跨平台（KMP）代码中，value class 对于提升类型安全非常有用

总结

Value Class 是Kotlin提供的零开销封装类型
它能解决 "多个业务概念复用同一底层类型" 导致的语义混淆问题
与 inline class 相比，value class 是正式稳定版本
它非常适合用于 ID、单位、领域模型等场景
在 Java 中，它就是一个普通类实例，有对象分配
在 Kotlin/Java 混合项目中，要注意性能与装箱问题

一句话：

Value Class = 类型安全 + 零开销，是业务建模的利器