State Hoisting测试夹具分离案例 - 第1节

## 1. State Hoisting 核心概念：定义、单向数据流、可测试性 ### 1.1 定义：状态提升的本质 State Hoisting（状态提升）是 Compose 中一种将可组合函数内部的状态“提升”到其调用者的模式。其核心原则为：**状态向下传递，事件向上流动**。当一个可组合组件需要管理状态，但其状态需要被父组件或其他兄弟组件共享时，该状态不应驻留在该组件内部，而应迁移到最近的、能控制所有需要该状态的组件的共同父级中。 ### 1.2 单向数据流架构 单向数据流是 State Hoisting 的实施基础。在 Compose 中，数据流形成一个闭环： 1. **状态向下传递**：父组件通过参数将当前状态值传递给子组件。 2. **事件向上传递**：子组件不直接修改状态，而是调用父组件提供的 lambda 回调，由父组件在回调中修改状态。 3. **重组驱动**：Compose 运行时监听状态变化，当状态被修改时，自动重组依赖该状态的所有组件。 这种架构消除了双向绑定的复杂性和难以追踪的隐式状态修改，使数据流的路径完全透明。 ### 1.3 可测试性优势 状态提升直接带来了组件可测试性的质变。未提升状态的组件很难进行单元测试，因为状态变更被封装在组件内部，测试代码无法注入或断言内部状态。提升后的组件则变成**纯 UI 函数**：给定输入（状态 + 回调），它总是产生确定的输出（UI 布局 + 事件触发）。 以下是一个对比示例，展示传统方式与状态提升方式的差异：

// 未提升状态 — 不可直接测试
@Composable
fun BadCounter() {
    var count by remember { mutableStateOf(0) }
    Button(onClick = { count++ }) {
        Text("计数：$count")
    }
}

// 状态提升 — 可直接测试
@Composable
fun GoodCounter(
    count: Int,
    onIncrement: () -> Unit
) {
    Button(onClick = onIncrement) {
        Text("计数：$count")
    }
}

### 1.4 状态提升与测试夹具的关联 测试夹具（Test Fixture）是测试环境中用于提供一致、可预测状态的辅助代码。State Hoisting 让测试夹具的构建变得简洁： - 只需要构造一个状态引用和一组模拟回调，即可驱动组件。 - 无需启动完整的应用上下文或依赖注入框架。 - 夹具可以单独维护和复用，与组件生产代码解耦。 下图展示了 State Hoisting 在单向数据流中的角色以及测试夹具如何接入该数据流： ### 1.5 概念差异对比 下表总结了传统状态管理方式与 State Hoisting 方式在多个维度上的差异： | 维度 | 传统方式（状态内聚） | State Hoisting 方式 | | --- | --- | --- | | **状态位置** | 声明在使用状态的组件内部 | 提升到父组件或 ViewModel | | **数据流方向** | 双向绑定或内部突变 | 单向数据流（仅向下传递） | | **可测试性** | 差，需要反射或集成测试环境 | 优秀，可构造纯函数测试 | | **组件复用** | 低，状态绑定特定上下文 | 高，组件完全解耦 | | **状态一致性** | 容易出现多份拷贝 | 单一数据源 | | **测试夹具** | 需要模拟整个组件上下文 | 只需要注入状态 + 回调 |