Kotlin中如何解构包含私有属性的数据类？

问题场景 #

当Kotlin数据类包含私有属性时，默认的解构声明会因权限问题失效。例如：

data class Product(
    private val id: Int,
    val name: String,
    val description: String
)

尝试解构时会触发编译错误：

val (_, name, description) = product  // 编译错误：Cannot access 'fun component1(): Int': it is private
val (name, description) = product     // 编译错误：Cannot access 'fun component1(): Int': it is private

只有将私有属性放在末尾时才能正常解构，但这种方案依赖属性顺序，适用性有限：

data class Product(
    val name: String,
    val description: String,
    private val id: Int
)

val (name, description) = product // 私有属性在末尾时可正常工作

解答：可以实现自定义解构，无需调整属性顺序 #

核心原因 #

Kotlin数据类会根据主构造函数的属性顺序自动生成componentN()方法，这些方法的访问权限与对应属性完全一致。当私有属性排在前面时，自动生成的component1()（对应私有id）是私有的，外部无法访问，导致解构失败。

可行方案 #

1. 手动在数据类内实现componentN()方法

直接在数据类中定义公有的componentN()方法，只暴露需要解构的属性：

data class Product(
    private val id: Int,
    val name: String,
    val description: String
) {
    // 自定义component1对应name，component2对应description
    operator fun component1(): String = name
    operator fun component2(): String = description
}

此时即可正常解构：

val (name, description) = product // 编译通过，正常工作

2. 通过扩展函数实现解构（适用于无法修改原类的场景）

如果不能修改原数据类的代码，可通过扩展函数添加公有的componentN()方法：

data class Product(
    private val id: Int,
    val name: String,
    val description: String
)

// 为Product添加解构用的扩展函数
operator fun Product.component1(): String = this.name
operator fun Product.component2(): String = this.description

同样能正常解构目标属性：

val (name, description) = product // 编译通过，正常工作

为什么私有属性在末尾时有效？ #

当私有属性排在末尾时，自动生成的component1()、component2()对应前面的公有属性，外部可正常访问；对应私有属性的component3()是私有的，但解构时只用到前两个方法，因此不会触发权限错误。但这种方式依赖属性顺序，不够灵活，不推荐作为通用方案。

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