mutableStateOf：创建可观察状态与Compose响应式机制

Jetpack Compose中的mutableStateOf是什么

mutableStateOf 是来自compose.runtime包的一个函数，它创建一个MutableState<T>对象，用于存储值并能够通知Compose Runtime有关变化。签名：fun <T> mutableStateOf(value: T, policy: SnapshotMutationPolicy<T> = structuralEquality()): MutableState<T>。参数policy决定何时变化被认为是重要的 — 在结构相等时、在引用相等时或从未。

MutableState是一个具有单一属性value的接口：用于读取的getter和用于写入的setter。当调用setter时，Compose Runtime在快照中记录变化，并将所有读取此State变量的Composable函数标记为需要重组。此过程在一个快照周期内同步发生，从而消除了级联变化中的中间状态。

Parameter policy — mutableStateOf的第二个参数，决定比较时的行为。structuralEquality()检查equals() — 这是默认行为。referentialEquality()检查===（引用相等）。neverEqual()将每次赋值视为变化。policy的选择影响在赋值相同值时是否触发重组。

mutableStateOf的语法和声明方式

声明可观察状态的最简单方式是使用 mutableStateOf 配合remember。没有remember，每次重组都会创建一个新的State，所有之前的变化都会丢失。remember保证同一个MutableState在Composable函数保持参与组合期间，能够存活一系列重组。

@Composable
fun Counter() {
    // 无委托：通过.value读/写
    val count = remember { mutableStateOf(0) }
    Button(onClick = { count.value++ }) {
        Text("Count: ${count.value}")
    }
}

@Composable
fun CounterDelegated() {
    // 有委托：var + by = 属性委托
    var count by remember { mutableStateOf(0) }
    Button(onClick = { count++ }) {
        Text("Count: $count")
    }
}

两种变体之间的区别是语法性的。Property Delegation（属性委托）(by) 使用Kotlin约定：编译器生成getValue()和setValue()调用来进行读取和写入。这等同于直接访问count.value，但看起来像使用普通变量。两种变体在功能上是相同的：Compose无论写入形式如何都跟踪getter中的读取和setter中的写入。

委托属性和var

Kotlin的委托属性机制不是Compose的特性，而是语言的内置功能。任何类都可以实现getValue(thisRef, property)和setValue(thisRef, property, value)运算符，之后其实例可以与关键字 by 一起使用。MutableState正是这样工作的：getValue返回当前值，setValue赋新值。

重要区别：val 和 var。mutableStateOf既可以赋值给val也可以赋值给var。在val的情况下（val count = mutableStateOf(0)），MutableState对象本身是不可变的，但其value属性可以改变。在var的情况下（var count by mutableStateOf(0)），委托创建了使用原始类型工作的假象，但实际上setter在MutableState上调用setValue。val和var之间的选择是对.value的显式和隐式访问之间的选择。

State Delegation（状态委托）是语法糖，简化了代码但不改变机制。Kotlin编译器将var x by mutableStateOf(0)转换为调用mutableStateOf.getValue()和mutableStateOf.setValue()的getter/setter。在生成的字节码中，val和var与by之间没有区别 — 两者都通过同一个MutableState容器工作。

    // Compose State的自定义委托
class ValidatedState<T>(initialValue: T) {
    private val state = mutableStateOf(initialValue)

    operator fun getValue(thisRef: Any?, property: KProperty<*>) = state.value

    operator fun setValue(thisRef: Any?, property: KProperty<*>, value: T) {
        if (value != state.value) {
            state.value = value
        }
    }
}

@Composable
fun Test() {
    var text by remember { ValidatedState("") }
}

Snapshot系统：mutableStateOf内部工作原理

Snapshot（快照）是Compose Runtime的一种机制，确保并行变化时State读取的一致性。当Composable函数读取mutableStateOf时，快照记录当前值。如果在组合过程中另一个变化写入同一个State，快照会看到写入，但不允许读取不一致的数据 — 读取始终返回快照开始时最新鲜的值。

当调用setter mutableStateOf.value = newValue时，Compose Runtime不会立即启动重组。相反，变化被记录在当前快照中。当快照被应用时（在帧边界），Compose遍历已更改的State列表并将读取组件标记为无效。只有在下一帧中才会启动重组。这保证了UI在级联变化时不会重绘数十次。

全局和本地快照：默认情况下，mutableStateOf在自动应用的全局快照中工作。可以通过Snapshot.takeSnapshot()创建本地快照，用于无副作用的隔离读取。这用于Modifier内部，需要读取State但不需要订阅变化。这种方法优化了性能并防止了意外的重组。

mutableStateOf使用示例

考虑一个真实场景 — 一个包含三个字段的登录表单：电子邮件、密码和加载状态。所有三个字段都使用 mutableStateOf，但具有不同的policy和不同的嵌套级别。电子邮件使用委托，密码 — 直接访问。

data class LoginState(
    val email: String = "",
    val password: String = "",
    val isLoading: Boolean = false,
    val error: String? = null
)

@Composable
fun LoginForm(onLogin: (String, String) -> Unit) {
    // 表单单一State，policy = referentialEquality
    var formState by remember {
        mutableStateOf(LoginState(), SnapshotMutationPolicy.referentialEquality())
    }

    val isValid = remember(formState) {
        formState.email.contains("@") && formState.password.length() >= 6
    }

    Column(modifier = Modifier.padding(16.dp)) {
        OutlinedTextField(
            value = formState.email,
            onValueChange = { formState = formState.copy(email = it) },
            label = { Text("电子邮件") }
        )
        OutlinedTextField(
            value = formState.password,
            onValueChange = { formState = formState.copy(password = it) },
            label = { Text("密码") },
            visualTransformation = PasswordVisualTransformation()
        )
        Button(
            onClick = { onLogin(formState.email, formState.password) },
            enabled = isValid
        ) {
            Text("登录")
        }
    }
}

在这个示例中，mutableStateOf与自定义数据类LoginState和policy referentialEquality一起使用。这意味着重组只会在通过copy()赋值新的LoginState实例时触发。isValid基于formState计算，并且仅在其变化时重新计算。这种方法提供了对重组的清晰控制：每个表单字段仅通过创建新副本来改变。