4. 状态提升基础：remember、mutableStateOf、state hoisting 模式

本章深入探讨 Jetpack Compose 状态管理的核心构建块。理解 remember、mutableStateOf 以及状态提升模式对于在 KMP 中构建健壮、可维护的 UI 至关重要，是构建复杂应用等高阶特性的基石。

4.1 理解状态和重组

在 Compose 中，状态 是任何随时间变化的值。UI 通过 重组 对状态变化做出反应——即重新执行已更改状态的组合项代码块，以更新 UI。

  • 状态来源： 通常是 MutableState、LiveData、StateFlow 或 RxJava 流。Compose 原生首选 mutableStateOf，它在 KMP 中完全可用。
  • 重组： Composable 函数重新执行以反映状态变化。Compose 编译器会跟踪在组合函数体内对状态对象的 读取 操作，只有读取了变化状态的组合才会被标记并重组。
  • 稳定性： 推荐使用稳定类型（基本数据类型、String、data class）以确保 Compose 能精准追踪变化，从而高效跳过不变部分的重组，这对性能至关重要。
  • 快照系统： Compose 使用并发快照系统管理状态，确保 UI 的一致性与线程安全，即便在多线程协程中更新状态也不例外。

4.2 remember 和 mutableStateOf 详解

这两个 API 是 Compose 状态管理的基石。remember 在重组中保留值，防止初始化丢失；而 mutableStateOf 创建可观察状态，驱动 UI 更新。

API用途作用域
remember在重组中存储对象，防止每次重组时重新初始化。与 mutableStateOf 搭配使用。Composable 作用域内
mutableStateOf创建 MutableState<T> 对象。Compose 订阅其 .value 的变化并触发重组。任何作用域，但推荐配合 remember 在组合中使用
rememberSaveable在重组和进程重建（如设备旋转）中保存状态，依赖 Bundle 机制。Composable 作用域内
最佳实践： 始终使用 remember 包裹 mutableStateOf 调用，确保状态在重组中存活。对于需要持久化或跨越配置变更的复杂对象，考虑使用 rememberSaveable 并配合自定义 Saver。

4.3 状态提升模式

状态提升（State Hoisting）是将状态移至组合项调用方（父级），使被调用组合项变为无状态组件的模式。它严格遵循 数据向下，事件向上 的单向数据流原则。

  1. 识别状态： 找出组合项内部的可变状态，例如 var text by remember { mutableStateOf("") }。
  2. 提升状态： 将状态声明替换为参数，即从外部接收状态值和事件回调。
  3. 父组合项持有状态： 调用方（父组合）负责创建并持有状态实例（通过 remember + mutableStateOf）。
  4. 传递数据与事件： 父级将当前状态向下传递（作为不可变参数），并将事件 lambda 向上传递（作为回调参数，由子组合触发）。

对比一下错误和正确的实现方式：

正确的状态提升代码示例：

// 父组合项：持有状态
@Composable
fun ParentComposable() {
    var text by remember { mutableStateOf("") }

    // 将状态向下传递，将事件向上传递
    ChildComposable(
        text = text,
        onTextChange = { newText -> text = newText }
    )
}

// 无状态子组合项：只依赖外部传入的值和回调
@Composable
fun ChildComposable(
    text: String,          // 状态向下（只读）
    onTextChange: (String) -> Unit  // 事件向上（回调）
) {
    TextField(
        value = text,
        onValueChange = onTextChange
    )
}

4.4 调试状态与重组

  • Compose 编译器报告： 配置 composeCompiler Gradle 插件的 reports 功能，生成 .txt 文件，查看每个组合项是否是 restartable、skippable 或 stateful，这直接影响性能。
  • 布局检查器： 在模拟器或真机上使用 Android Studio 的 Layout Inspector，实时查看当前组合树的层级、状态值和重组次数。
  • 重组计数高亮： 在调试依赖中添加 implementation("com.jakewharton.madge:madge:...") 这类库，或使用 Modifier.debugInspectorInfo() 标记重组边界。
  • 日志追踪： 利用 snapshotFlow 观察 mutableStateOf 的变化流，在协程中收集并打印日志，验证状态更新时机。

4.5 常见错误与避坑

1. 忘记 remember： 在组合项内直接使用 val state = mutableStateOf(0) 会导致每次重组时状态丢失并被重置为初始值。
2. 提升不足： 将状态保留在需要被多个同级组件共享，或需要向上传递到更高级别的子组合项中。例如：列表筛选逻辑应提升至列表持有者，而非列表项本身。
3. 在非组合作用域误用 remember： remember 只能在 @Composable 函数或 lambda 内调用。在普通函数或协程中想使用可观察状态时，应改用 mutableStateListOf 或直接持有 MutableState 对象。
4. 直接修改可变集合引用： 使用 var list by remember { mutableStateOf(mutableListOf(...)) } 并直接调用 list.add(...)，Compose 只会追踪 list 属性的引用是否变化，而非列表内容。必须使用 mutableStateListOf 来追踪集合内部变化。

4.6 性能与稳定性优化

  • 最小化状态范围： 将状态定义在尽可能低的组合层级。不要将 UI 状态提升到不需要它的父级，避免引发大规模不必要的重组。
  • 使用 derivedStateOf： 当状态由其他状态计算得出时（如列表过滤），使用 derivedStateOf 缓存计算结果，避免重复计算和不必要的重组。
  • 稳定 Lambda 表达式： 使用 remember 缓存 lambda 实例（如 onClick = remember { { doSomething() } }），或使用 ViewModel 的成员函数引用，帮助 Compose 跳过对子组件的重组。
  • 使用 key 参数： 在 remember(key) { ... } 中指定键，当依赖变化时重新计算值，避免不正确的缓存。
  • 协程与快照系统： 从协程中更新 mutableStateOf 时，注意 Compose 的快照系统要求从快照内部读取状态。在协程中使用 withFrameMillis 或 snapshotFlow 安全地驱动 UI 更新，防止并发冲突。

4.7 内联 SVG：状态提升模式图

状态提升模式 (State Hoisting Pattern) 持有状态的组合项 remember + mutableStateOf 无状态子组合项 状态 (State) text value, loading flag 事件 (Event) onTextChange, onIncrement 单向数据流原则 数据向下传递 (不可变) 事件向上传递 (回调)

4.8 从 ViewModel 部署状态提升

在 KMP 的实际架构中，ViewModel 通常是业务逻辑层和状态的实际持有者。Compose UI 层通过订阅 ViewModel 暴露的状态流来驱动界面更新，这是状态提升模式的延伸。

// ViewModel (commonMain)
class MyViewModel {
    private val _uiState = MutableStateFlow(UiState())
    val uiState: StateFlow = _uiState.asStateFlow()

    fun onEvent(event: UiEvent) { ... }
}

// Compose UI Layer
@Composable
fun MyScreen(viewModel: MyViewModel) {
    val uiState by viewModel.uiState.collectAsState()

    MyContent(
        uiState = uiState,
        onEvent = viewModel::onEvent
    )
}

// 纯 UI 表达的无状态组合函数
@Composable
fun MyContent(
    uiState: UiState,
    onEvent: (UiEvent) -> Unit
) { ... }

这种分层状态提升模式确保了 UI 可以独立于业务逻辑进行预览和单元测试，在 KMP 多平台环境中实现了最大限度的代码复用。

4.9 要点总结

  • remember 用于在重组中保留状态；mutableStateOf 用于创建可观察对象并驱动重组。
  • 状态提升模式创建了可预测的架构：单一数据源和严格单向数据流。
  • 始终将状态声明上移到实际需要它的最低公共父级，避免状态冗余。
  • 使用 derivedStateOf 和稳定的 lambda 表达式优化重组性能。
  • 在 KMP 共享模块中，推荐使用 StateFlow 配合 collectAsState() 实现健壮的架构分层。
← 上一章 📖 返回目录 下一章 →