SuperAPI AI 工具集

kotlin-types-value-class

通用与其它

查看项目

更新于 10-16 05:42

技能介绍

用途:在编写或审查 Kotlin 类型声明时,判断何时用 @JvmInline value class 代替 data class,尤其涉及 Compose 参数稳定性。核心原则是对承载领域含义的单字段类型优先用 value class,以获得类型安全且避免 data class 的分配开销;data class 更适合聚合多个字段。

主要能力:提供决策流程。单字段且具领域含义(如 UserId、EmailAddress、Percentage)选 @JvmInline value class;单字段但无领域含义用类型别名或保留原始类型;多字段、需要自定义 equals/hashCode/toString 时用 data class。value class 在底层类型稳定时被 Compose 编译器视为 Stable,可避免“unstable parameter”警告,无需在 Compose 边界加 @Immutable,并能提升可跳过性。

限制与陷阱:作为可空(UserId?)、泛型参数(List<UserId>)或 vararg 时会装箱分配,热路径需注意;不能使用 init 块、lateinit 或委托属性;没有 copy()、component1() 解构,也不能自定义 toString();equals/hashCode 委托给底层类型;用 kotlinx.serialization 时序列化为底层值而非对象,替换单字段 data class 是 API/JSON 契约的破坏性变更,Jackson 可能需配置;从 Java 看呈现为底层类型;反射与运行时会擦除。仅一个字段,但 Compose 的 packFloats、packInts 及对应 unpack*(androidx.compose.ui.util)可将多个原始值打包进单个 Long,仅建议用于性能关键路径。使用方式以类型声明与审查决策为主,具体命令与安装方式暂未提供。适用场景为 Kotlin 类型设计、Compose 稳定性优化与代码审查。