如何仅为Kotlin数据类（Data Class）创建通用扩展函数？

好的，我来帮你解决这个问题——想要一个只对Kotlin数据类生效的convertToJson扩展函数，同时避免泛型函数对所有对象开放的问题。因为Kotlin本身没有直接的编译时约束来限定扩展函数仅作用于数据类（数据类是类修饰符，不属于类型层级），这里有两种可行的方案：

方案一：标记接口+编译时约束（推荐，安全可控） #

这种方式通过一个空的标记接口，让所有目标数据类实现它，然后给这个接口编写扩展函数。这样只有实现了接口的数据类才能调用该函数，编译时就会拦截非数据类的调用。

// 定义一个空的标记接口，用于标识支持JSON转换的数据类
interface DataClassConvertible

// 让你的数据类实现这个接口
data class Person(val name: String, val age: Int) : DataClassConvertible
data class Car(val color: Color, val brand: String) : DataClassConvertible

// 仅针对标记接口编写扩展函数
fun DataClassConvertible.convertToJson(): String {
    return Gson().toJson(this)
}

优点： #

• 编译时安全：非数据类（或未实现接口的类）调用convertToJson会直接报错，提前避免错误
• 代码清晰：通过接口明确标识哪些类支持该功能
• 性能好：不需要反射，运行时无额外开销

缺点： #

• 需要手动给每个数据类添加接口实现，稍微有点繁琐

方案二：运行时反射检查（无需修改现有数据类） #

如果你不想修改现有的数据类，可以利用Kotlin反射在运行时检查当前对象是否为数据类，非数据类调用时抛出异常。

import kotlin.reflect.full.isData

// 给Any类写扩展，但内部做数据类校验
fun Any.convertToJson(): String {
    // 检查当前对象是否是数据类，不是则抛出异常
    require(this::class.isData) { "convertToJson() can only be called on Kotlin data classes" }
    return Gson().toJson(this)
}

优点： #

• 无需修改现有数据类，直接使用
• 逻辑简单，快速实现

缺点： #

• 编译时无约束：非数据类调用该函数不会报错，只有运行时才会抛出异常
• 有反射开销：虽然对于JSON转换来说这点开销可以忽略，但高频场景下需要注意

方案选择建议 #

• 如果你希望严格的编译时安全，且愿意给数据类添加标记接口，优先选方案一
• 如果你不想改动现有代码，能接受运行时检查的风险，选方案二

内容的提问来源于stack exchange，提问作者Abdullah Alomair