3. 手动实现状态提升：从局部状态到提升状态、回调函数设计、状态来源明确化

可组合函数内部使用 remember + mutableStateOf 声明的状态是局部状态（local state）。当状态需要被父组件读取、被兄弟组件共享或参与跨层级交互时，必须提升（hoist）到调用方。本章完整演示手动提升的每一步：剥离局部状态、设计回调函数、明确状态唯一来源。

3.1 原理：单向数据流与状态下沉

状态提升遵循单向数据流（Unidirectional Data Flow）：

• 状态向下传递：父组件通过参数将状态传给子组件。
• 事件向上传递：子组件通过回调函数将用户操作通知父组件。
• 单一可信来源：每个可变化的状态只在一个位置被定义和管理。

3.2 实现流程：四步提升法

1. 识别局部状态：找出子组件中用 remember 包裹的状态。
2. 定义状态参数：将状态值提升为父组件的函数参数。
3. 定义事件回调：为每个状态更新操作定义回调函数类型。
4. 替换调用点：父组件传入状态值和回调，子组件内部不再拥有 remember。

步骤	子组件代码变化	父组件新增代码
1	删除 remember 声明	添加 val state = remember { mutableStateOf(...) }
2	将 state 替换为参数 value	将 state.value 传入子组件
3	将 state.value = new 替换为回调调用	定义 onValueChange: (T) -> Unit 参数
4	验证子组件不再引用 remember	传入 onValueChange = { state.value = it }

3.3 代码示例：从局部滑动开关到受控开关

阶段一：局部状态（未提升）

@Composable
fun LocalToggleSwitch() {
    var isChecked by remember { mutableStateOf(false) }

    Switch(
        checked = isChecked,
        onCheckedChange = { isChecked = it }
    )
}

阶段二：手动提升（四步实现）

// 1. 子组件变为无状态：只接收参数
@Composable
fun StatelessToggleSwitch(
    isChecked: Boolean,
    onCheckedChange: (Boolean) -> Unit
) {
    Switch(
        checked = isChecked,
        onCheckedChange = onCheckedChange
    )
}

// 2. 父组件持有状态并传入
@Composable
fun ParentScreen() {
    var isChecked by remember { mutableStateOf(false) }

    StatelessToggleSwitch(
        isChecked = isChecked,
        onCheckedChange = { newValue ->
            isChecked = newValue
            // 此处可附加日志、校验或副作用
            println("Toggle changed to: $newValue")
        }
    )
}

3.4 回调函数设计原则

• 参数最小化：回调只传递必要的数据（例如 Boolean、String、Int），避免传递完整状态对象。
• 事件命名语义化：使用 onEvent 模式（如 onSearch、onDelete），而非 onValueChange 泛称。
• 避免闭包捕获：父组件 lambda 内尽量使用 it 或显式参数，防止被错误缓存。
• 可选回调默认值：如果回调非必须，可提供 onEvent: ((T) -> Unit)? = null，调用时使用 ?.invoke()。

3.5 状态来源明确化：单一可信来源（Single Source of Truth）

提升后，状态只在一个位置定义：父组件。状态来源清晰体现在：

• 读取状态时直接访问父组件的 state.value。
• 修改状态时只能通过回调，父组件决定是否、何时以及如何更新。
• 多个子组件若共享同一状态，父组件只需传递相同的 state.value 和 onCheckedChange。

3.6 调试要点

1. 开启 Compose 重组合日志：在 build.gradle.kts 中添加 debugImplementation("androidx.compose.ui:ui-tooling:1.7.0")，使用 Layout Inspector 观察参数变化。
2. 在回调中插入日志确认事件触发顺序。
3. 检查状态是否出现“双重定义”：子组件不应同时拥有 remember 版本。

3.7 性能与稳定性优化

• 避免不必要的重组：回调函数使用 remember 包裹 Lambda，避免每次重组都创建新对象。
• 状态类型选择：简单值用 mutableStateOf，复杂数据用 mutableStateListOf 或 mutableStateMapOf 以减少快照开销。
• 副作用隔离：在父组件回调内避免直接执行 I/O 操作，应委托给 ViewModel。
• 稳定性注解：为状态类加上 @Stable 或 @Immutable，帮助 Compose 编译器跳过不必要的比较。

3.8 状态提升流程图

3.9 常见错误与修正

错误	表现	修正
子组件残留 remember	状态无法被父组件控制，出现双状态	删除子组件内部所有 remember、mutableStateOf
回调函数类型不匹配	编译错误或类型推断失败	显式声明 onValueChange: (Boolean) -> Unit
父组件未使用 remember	重组导致状态丢失	用 remember 包裹 mutableStateOf
回调中直接修改外部作用域变量	状态更新不同步	始终赋值给 state.value 或委托属性

3.10 总结