原生移动开发 / 系统课时
LazyColumn 与 LazyRow
LazyColumn 与 LazyRow
当列表拥有几十、几百甚至更多条数据时,不应再用 Column.verticalScroll 或 Row.horizontalScroll 一次组合全部子项。本节使用 LazyColumn 和 LazyRow 构建纵向、横向列表,并通过稳定 key 保持项目身份。
学习目标
- 使用
LazyColumn、LazyRow与items渲染集合数据 - 理解惰性列表只组合可见区域附近项目的工作方式
- 使用稳定
key降低列表重排时的状态错位风险
惰性列表只处理需要显示的项目
LazyColumn 和 LazyRow 的核心区别不在“能滚动”,而在“按需组合”。列表的数据源可以很大,但 Compose 不需要在首次进入页面时把所有项目都完整组合出来,而是围绕当前可视窗口创建需要显示的内容。

这种机制非常适合动态数据列表。它不会改变业务数据本身,只是改变 UI 项目的创建时机。
组合纵向和横向列表
下面示例在顶部使用 LazyRow 展示分类,在下方使用 LazyColumn 展示 200 个产品。代码可直接放入已启用 Jetpack Compose 的 Android 项目中。
package com.example.lazysample
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.fillMaxWidth
import androidx.compose.foundation.layout.height
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.weight
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.LazyRow
import androidx.compose.foundation.lazy.items
import androidx.compose.material3.Card
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
data class Product(val id: Int, val name: String)
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
MaterialTheme {
ProductScreen()
}
}
}
}
@Composable
fun ProductScreen() {
val categories = listOf("推荐", "手机", "电脑", "配件", "家居", "图书")
val products = List(200) { index ->
Product(id = index + 1, name = "产品 ${index + 1}")
}
Column(
modifier = Modifier
.fillMaxSize()
.padding(16.dp)
) {
LazyRow(
modifier = Modifier.height(52.dp),
horizontalArrangement = Arrangement.spacedBy(8.dp)
) {
items(categories) { category ->
Card {
Text(category, modifier = Modifier.padding(12.dp))
}
}
}
LazyColumn(
modifier = Modifier
.fillMaxWidth()
.weight(1f),
verticalArrangement = Arrangement.spacedBy(8.dp)
) {
items(
items = products,
key = { product -> product.id }
) { product ->
Card(modifier = Modifier.fillMaxWidth()) {
Text(
text = "${product.id}. ${product.name}",
modifier = Modifier.padding(16.dp)
)
}
}
}
}
}预期结果
页面顶部出现可左右滑动的分类条;下方出现可上下滑动的产品列表,能够连续浏览“产品 1”到“产品 200”。LazyRow 被限制为固定高度,LazyColumn 通过 weight(1f) 获得剩余空间,因此两个滚动区域都有明确边界,也不会互相争夺同一方向的滚动。
key 用来描述项目身份
items 可以接收 key。当列表会插入、删除或重新排序时,稳定 key 能帮助 Compose 识别“这是原来的哪一个项目”,从而更可靠地保留与项目相关的状态。
示例使用 product.id 作为 key,前提是同一列表中它必须唯一且稳定。不要把当前索引当作可重排数据的长期身份,因为项目位置变化后,索引也会变化。
在 LazyColumn 中组织不同类型内容
惰性列表不仅能渲染集合,还能插入单个项目。例如可以先用 item { ... } 放标题,再用 items(...) 渲染数据,再追加一个尾部提示。这样同一个滚动容器可以承载不同类型内容,而不必再套一层同方向 verticalScroll。
需要分页加载、滚动位置控制或“滚到底加载更多”时,也应继续基于 LazyColumn、LazyRow 及其状态对象扩展,而不是退回一次性组合全部内容的普通滚动容器。