1. 状态提升核心概念与单向数据流

Jetpack Compose 的状态管理遵循 单向数据流（Unidirectional Data Flow, UDF）原则。所谓“状态提升”（State Hoisting），是指将可变的 MutableState 从可组合函数内部提取到其调用方（通常是上层可组合或 ViewModel），使当前函数成为无状态的“纯 UI”组件，并通过回调向上传递用户事件。

1.1 核心定义

概念说明
状态提升将可变状态从 Composable 中上移，让该 Composable 只接收状态和事件回调，不再直接持有可变状态。
单向数据流状态向下（父→子）传递，事件向上（子→父）传递；数据变更路径清晰、可预测。
MutableStateCompose 的可观察状态容器，值变化会触发依赖它的 Composable 重组。
重组（Recomposition）当可观察状态改变时，Compose 运行时重新执行受影响的可组合函数 lambda，生成新的 UI 快照。

1.2 状态提升与 MutableState 的关系

在 Compose 中，remember { mutableStateOf(initialValue) } 通常用于在 Composable 内创建局部状态。若将该状态提升到外部（如 ViewModel 或父 Composable），则通过参数传入 State<T>（只读）和 (T) -> Unit（回调）。

关键点：状态提升不改变 MutableState 的“可观察性”，只是将它的所有权移出当前 Composable。组件依然通过读取 value 属性与重组机制绑定。 
// 局部状态（不提升）
@Composable
fun CounterLocal() {
    var count by remember { mutableStateOf(0) }
    Button(onClick = { count++ }) { Text("点击 $count") }
}

// 状态提升（父组件控制状态）
@Composable
fun CounterHoisted(count: Int, onIncrement: () -> Unit) {
    Button(onClick = onIncrement) { Text("点击 $count") }
}

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

1.3 重组触发条件

Compose 重组由 快照系统（Snapshot System）驱动。当 MutableState.value 被写入新值时，所有在当前重组周期中读取过该状态的可组合 lambda 会被标记为“需要重组”。

  1. 读取：只有在重组期间通过 .value 或属性委托读取的 MutableState 才会被追踪。
  2. 写入：写入新值后会触发下次帧的合并调度，批量重组。
  3. 跳过条件：若 Composable 的所有输入（参数）显式相等（equals），重组时可跳过（依赖稳定性分析）。
调试技巧：使用 Compose 编译器报告 或 Android Studio 的“Recomposition Counts”工具观察重组次数，避免不必要的状态依赖。

1.4 单向数据流结构图

状态提升与单向数据流 屏幕/ViewModel（拥有状态） val count = mutableStateOf(0) 可组合组件A（推荐状态提升形式） 参数: count: Int, onIncrement: ()->Unit 状态 (count) 子组件（仅读取） Text("Count: $count") 事件 (onIncrement) 子组件（触发事件） Button(onClick = onIncrement) 数据方向：向下 事件方向：向上

1.5 常见错误与性能要点

⚠ 反模式：在子 Composable 内部再次调用 remember { mutableStateOf(...) } 会破坏状态提升，导致父组件无法控制状态，且容易造成数据不一致。始终优先使用参数回调形式。
  • 过度拆分状态：将单个逻辑状态拆成多个 MutableState 会导致多次独立重组。使用 data class 组合为不可变快照。
  • 跳过重组失效：若传入 lambda 每次重组都创建新对象（如 onClick = { state.value++ }），稳定性分析无法跳过。使用 remember 或稳定回调引用。
  • 性能监控：在 Profile 模式下查看 “Compose: Recompose Count”，若频繁出现不应重组的组件，检查参数是否使用了不稳定类型（如 List、Map 等）。

1.6 实现流程小结

  1. 确定 Composable 内哪些数据是需要可变的状态（能用 mutableStateOf）。
  2. 将状态提升到最近的共同父组件或 ViewModel 中，使用 remember 或 viewModelScope 管理生命周期。
  3. 将状态（只读 State<T> 或 T）作为参数传入子 Composable。
  4. 将修改状态的事件封装为回调（如 onValueChange: (T) -> Unit）并传递下去。
  5. 在父组件中实现回调逻辑，修改状态值，触发重组。
// 完整状态提升示例
@Composable
fun SearchBar(query: String, onQueryChange: (String) -> Unit) {
    TextField(
        value = query,
        onValueChange = onQueryChange,
        placeholder = { Text("搜索...") }
    )
}

@Composable
fun SearchScreen(viewModel: SearchViewModel = viewModel()) {
    val query by viewModel.query.collectAsState()
    SearchBar(query = query, onQueryChange = viewModel::updateQuery)
}

SearchBar 不持有任何 mutableStateOf，完全由 SearchScreen 或 SearchViewModel 控制状态。这保证了可测试性、可复用性以及重组路径的简洁。

← 上一章 📖 返回目录 下一章 →