原生移动开发 / 系统课时
列表项、Key 与性能
列表项、Key 与性能
Lazy 列表看似只要 items() 就能工作,但一旦发生插入、删除、排序或列表项持有本地状态,默认按位置识别项目就可能带来状态错位。本篇通过可运行示例把列表项拆分、稳定 Key、rememberSaveable 与常见性能边界串起来。
学习目标
- 为可变列表设计稳定且唯一的
key - 让列表项本地状态在重排与界面重建时保持正确归属
- 识别 Lazy 列表中常见的性能误区并选择合适优化手段
列表项应该拥有稳定身份
Lazy 列表默认可以按项目位置组织内容,但位置不是业务身份。若第 2 个项目被插到第 1 个位置,旧的“位置 1”已经对应另一个对象;此时项目内部的 remember 状态、动画或滚动子状态都可能跟错对象。
为 items() 提供 key 后,Compose 可以用业务身份追踪项目。Key 必须在同一列表中唯一,并且在对象重排后保持不变。数据库主键、服务器 ID 或本地生成后持久保存的 ID 都适合;数组索引只在项目永不插入、删除、重排时才勉强安全。

用 Key 验证状态是否跟随项目
下面的页面允许反转联系人顺序。每一行都有自己的备注输入框,并使用 rememberSaveable 保存输入;items 以联系人 id 作为 Key。先给“阿青”输入备注,再点击“反转顺序”,可以直接观察状态是否仍属于同一个联系人。
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.PaddingValues
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.height
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.items
import androidx.compose.material3.Button
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.OutlinedTextField
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
data class Contact(
val id: Long,
val name: String
)
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
MaterialTheme {
ContactListDemo()
}
}
}
}
@Composable
fun ContactListDemo() {
var contacts by remember {
mutableStateOf(
listOf(
Contact(101L, "阿青"),
Contact(202L, "小林"),
Contact(303L, "小周")
)
)
}
Column(modifier = Modifier.fillMaxSize()) {
Button(
onClick = { contacts = contacts.reversed() },
modifier = Modifier.padding(16.dp)
) {
Text("反转顺序")
}
LazyColumn(
modifier = Modifier
.fillMaxWidth()
.height(420.dp),
contentPadding = PaddingValues(horizontal = 16.dp, vertical = 8.dp),
verticalArrangement = Arrangement.spacedBy(12.dp)
) {
items(
items = contacts,
key = { contact -> contact.id }
) { contact ->
ContactRow(contact)
}
}
}
}
@Composable
private fun ContactRow(contact: Contact) {
var note by rememberSaveable { mutableStateOf("") }
OutlinedTextField(
value = note,
onValueChange = { note = it },
label = { Text("${contact.name} 的备注") },
modifier = Modifier.fillMaxWidth()
)
}预期结果:在“阿青”的输入框键入“下周联系”后点击“反转顺序”,阿青会移动到列表另一端,但“下周联系”仍显示在阿青对应的输入框中。旋转屏幕等 Activity 重建场景下,rememberSaveable 还会尝试恢复可保存状态;实际系统重建行为取决于宿主环境。
拆分列表项但不要误解重组
把 ContactRow 这类项目 UI 提取为独立 Composable,主要收益是职责清晰、参数边界明确、便于预览和测试。它并不意味着“拆成函数就一定更快”。真正影响重组范围的是状态在哪里读取、参数是否变化,以及传入数据是否具有稳定语义。
项目级瞬时 UI 状态可以放在项目内部,但业务状态更适合提升到状态持有者或 ViewModel。若状态必须跨进程重建长期存在,应保存业务数据或可恢复输入,而不是依赖 Lazy 列表项目一直留在 Composition 中。
把优化放在真正有成本的地方
Lazy 布局本身按视口需要组合内容,但项目仍可能因为昂贵计算、尺寸剧烈变化或不必要的数据变化而卡顿。优化时优先检查这些问题:
- 异步图片或占位内容不要先以接近
0.dp的尺寸出现,再突然扩张;尽量让加载前后尺寸稳定。 - 不要在每次项目重组时执行排序、过滤、图片解码等重计算;可把结果移到上游状态层,或在确有必要时使用合适的缓存。
- 混合多种结构明显不同的项目时,可以为
items提供contentType,让可复用的组合尽量发生在同类项目之间。 - 性能判断应以 release 构建和实际设备测量为准,不要仅凭 debug 模式滚动手感下结论。
当列表数据可能变化时,先给项目稳定身份,再决定状态放在项目内部还是提升到上层,最后针对真实测量结果优化。这比一开始堆叠缓存或强行减少 Composable 数量更可靠。