原生移动开发 / 系统课时
状态提升
状态提升
状态提升解决的是“谁拥有状态、谁只负责展示”的问题。把需要被外部控制的状态移到调用方,再通过参数向下传值、通过回调向上传事件,可以让 Compose 组件更容易复用、预览和测试。
学习目标
- 理解状态提升中的单一数据源与事件回传
- 用
value/onValueChange风格把有状态组件改成无状态组件 - 判断状态应该保留在组件内部还是提升到调用方
状态提升改变了什么
如果一个组件既保存状态又修改状态,调用方很难指定它当前显示什么,也很难在测试中稳定复现某个状态。状态提升的核心不是“把 remember 往上挪”,而是明确两条数据方向:状态从拥有者向下传递,用户事件从子组件向上回传。

这会形成单一数据源:只有调用方真正修改 count,子组件只根据参数渲染。相同的无状态组件因此可以接入内存状态、ViewModel 状态或测试状态,而不用改变内部实现。
用调用方持有唯一状态
下面的代码可直接替换 Compose Activity 模板中的 MainActivity.kt。CounterScreen 持有状态,Stepper 只接收当前值和事件回调。
package com.example.statehoisting
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Button
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
MaterialTheme {
CounterScreen()
}
}
}
}
@Composable
fun CounterScreen() {
var count by rememberSaveable { mutableStateOf(0) }
Stepper(
count = count,
onIncrement = { count += 1 }
)
}
@Composable
fun Stepper(
count: Int,
onIncrement: () -> Unit
) {
Column(
modifier = Modifier
.fillMaxSize()
.padding(24.dp),
verticalArrangement = Arrangement.spacedBy(12.dp)
) {
Text("数量:$count")
Button(onClick = onIncrement) {
Text("+1")
}
}
}预期结果如下。
首次打开:数量:0
点击“+1”一次:数量:1
继续点击:数量按 2、3、4……递增Stepper 没有自己的 remember,因此只要传入相同的 count,它就会得到相同的主要界面状态。测试时可以直接传 count = 3 检查文本,再触发按钮验证 onIncrement 是否被调用,而不必先把组件内部状态操作到指定值。
状态应该提升到哪里
状态通常提升到“所有需要读取或修改它的组件的最近共同调用方”。如果只有当前组件使用某个临时 UI 状态,例如某个独立提示是否展开,而且外部既不关心也不需要控制,就可以继续保留在组件内部。
当状态需要被多个子组件共享、需要由 ViewModel 驱动、需要在调用方决定默认值,或需要独立测试组件时,再把它提升。提升过高会让上层充斥只与局部 UI 有关的变量;提升过低则会产生多个状态源,最终出现界面不同步。
判断是否完成状态提升,可以检查一个简单条件:子组件是否只通过参数获得状态,并且只通过回调表达“发生了什么”。满足这个条件后,组件的状态所有权就清晰了。