1. 认识状态提升：概念定义、核心原则、单向数据流模型

状态提升（State Hoisting）是 Jetpack Compose 中管理 UI 状态的核心模式。它通过将状态从可组合函数中抽离到调用方或 ViewModel，实现状态与 UI 的解耦，让组件变得可测试、可复用且可预测。

1.1 概念定义

在 Compose 中，状态提升指将原本由子组件管理的状态，提升到父组件或专门的容器（如 ViewModel）中管理，再通过参数将状态值和事件回调向下传递。子组件仅负责展示和上报意图，不直接持有可变状态。

核心公式： 状态提升 = 状态值（State）向下传 + 事件回调（Event）向上传。

1.2 核心原则

原则说明
单一数据源每个可变状态只在一个地方定义，避免多份副本导致不一致
状态向下父组件通过参数将状态值传递给子组件，子组件只读
事件向上子组件通过回调（如 lambda）通知父组件用户操作，由父组件更新状态
可预测数据总是沿着树形结构单向流动，调试和测试时能清晰追踪变化来源

1.3 单向数据流模型

单向数据流（Unidirectional Data Flow，UDF）是状态提升的底层模型。数据永远按照一个方向流动：UI 触发事件 → ViewModel 更新状态 → 新状态流向 UI。整个过程形成一个闭环，但方向固定。

单向数据流模型（UDF） UI（Composable） ViewModel Data Layer 事件 请求 数据响应 状态（State） 箭头方向代表数据流动方向：事件向上，数据/状态向下 任何状态的更改都必须经过 ViewModel 的“更新”步骤

1.4 实现流程：从局部状态到提升状态

  1. 定义状态接口：在父组件中声明需要提升的状态类型，例如 counter: Int 和 onIncrement: () → Unit。
  2. 移除子组件内部状态：子组件不再使用 remember { mutableStateOf(...) }，改为接收参数。
  3. 在父组件创建并持有状态：父组件使用 remember 或 ViewModel 创建状态，并将值和回调传入子组件。
  4. 事件驱动更新：子组件调用 onIncrement，父组件更新状态，新状态自动触发重组。
提示： ViewModel 中的状态应使用 StateFlow 或 MutableState 收集到 Compose 中。对于纯 Compose 层的简单状态，remember + mutableStateOf 已足够。

1.5 代码示例：计数器状态提升前后对比

❌ 未提升（子组件持有状态）

@Composable
fun CounterBad() {
    var count by remember { mutableStateOf(0) }
    Column {
        Text("Count: $count")
        Button(onClick = { count++ }) {
            Text("+")
        }
    }
}

✅ 状态提升后（父组件管理状态，子组件仅展示）

@Composable
fun CounterScreen() {
    var count by remember { mutableStateOf(0) }
    CounterDisplay(count = count, onIncrement = { count++ })
}

@Composable
fun CounterDisplay(count: Int, onIncrement: () -> Unit) {
    Column {
        Text("Count: $count")
        Button(onClick = onIncrement) {
            Text("+")
        }
    }
}

1.6 常见错误与调试

常见错误后果正确做法
子组件直接修改父组件传来的可变对象违反单一数据源，UI 可能不更新始终通过回调让父组件负责更新
将 MutableState 对象传递给子组件子组件可以修改状态，失去可预测性只传递不可变的 State<Int> 或直接传值
在多个子组件中重复定义相同状态状态不同步，出现不一致提升到最近的共同父组件
注意： 使用 Android Studio 的 Layout Inspector 可以实时查看组件树中状态的值，帮助定位状态提升是否正确。如果发现一个状态在多个地方变化，说明提升层级不够。

1.7 性能与稳定性要点

  • 状态提升不引入额外性能开销，Compose 重组只针对实际变化的状态。
  • 避免将整个 ViewModel 或大对象传递给子组件，应只传递需要的值和回调，减少重组范围。
  • 对于高频事件（如滑动），考虑使用 derivedStateOf 或 snapshotFlow 进行优化。
← 上一章 📖 返回目录 下一章 →