State 与 MutableState 基础：remember 与 mutableStateOf 创建可观察状态

原理：Compose 的声明式状态驱动重组

在 Jetpack Compose 中，UI 不是手动更新的，而是通过 状态 驱动的。当状态发生改变时，Compose 框架会自动重组（Recompose）该状态所关联的 Composable 函数，从而更新 UI。这一机制的核心是 可观察状态（Observable State）。

MutableState 是 Compose 中最基础的观察容器，它持有一个可变的值，并在值变化时通知 Compose 框架。

remember 函数用于保持对象跨重组（Recomposition）的存在性；没有 remember 包裹的状态会在每次重组时被重新创建，从而丢失变化。

实现流程：从创建到触发重组

1. 在 Composable 函数内通过 mutableStateOf() 创建初始状态（返回 MutableState）。
2. 用 remember 将状态包裹，避免在每次重组时被重建。
3. 读取 value 属性（或使用 Kotlin 委托 by）来驱动 UI。
4. 修改 value 时，Compose 检测到变化，自动触发包含该 state 读取的 Composable 重组。

核心代码示例：计数器

@Composable
fun CounterExample() {
    // 使用 remember 保持状态，mutableStateOf 创建可观察状态
    var count by remember { mutableStateOf(0) }

    Column(
        modifier = Modifier.padding(16.dp),
        horizontalAlignment = Alignment.CenterHorizontally
    ) {
        Text(
            text = "你点击了 $count 次",
            style = MaterialTheme.typography.headlineMedium
        )
        Spacer(modifier = Modifier.height(8.dp))
        Button(onClick = { count++ }) {
            Text("增加")
        }
        Spacer(modifier = Modifier.height(4.dp))
        Button(onClick = { count = 0 }) {
            Text("重置")
        }
    }
}

API 要点速查表

调试：验证状态与重组

• Android Studio Layout Inspector：部署应用后，使用 Layout Inspector 观察组件树，可以看到被重组的节点标记。
• Compose 编译器日志：在 build.gradle 中开启 composeCompilerMetrics 可输出重组统计。
• 手动日志：在 Composable 函数内打印日志（例如 Log.d("Counter", "recompose")），观察调用次数。
• @Stable 注解：对于自定义类，标记 @Stable 可以帮助 Compose 更准确地判断不变性，减少不必要的重组。

性能与稳定性优化