0Pricing
Android Academy · 课时

使用 LazyColumn 构建列表

高效显示可滚动列表

使用 LazyColumn 构建列表 是 CoddyKit 上的免费 Android Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Android Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Android Academy 课程共包含 4 节课。

为什么不直接使用 Column？

Column 会一次性组合所有子项。对于很长或可滚动的列表，这会浪费内存并拖慢界面。您需要一种只构建可见项的列表。

使用 LazyColumn

LazyColumn 是一个可滚动的垂直列表，只会组合当前显示在屏幕上的项——类似旧版的 RecyclerView，但简单得多。

LazyColumn {
    items(messages) { msg ->
        Text(text = msg)
    }
}

items() 函数

在 LazyColumn 的 Lambda 中调用 items(list)，并为每个元素提供一个可组合项。Compose 会随着用户滚动按需调用它。

LazyColumn {
    items(users) { user ->
        Text(text = user.name)
    }
}

不是普通循环

请不要在 LazyColumn 中使用普通的 for 循环——那会破坏延迟加载。请始终使用 items()（或 itemsIndexed()），这样 Compose 才能按需构建列表项。

单个标题项

使用单数形式的 item { } 添加一个固定元素，例如在循环项之前添加标题。

LazyColumn {
    item { Text("Header") }
    items(data) { Text(it) }
}

itemsIndexed

需要位置时，请使用 itemsIndexed 同时获取索引和元素。

LazyColumn {
    itemsIndexed(data) { index, value ->
        Text(text = "$index: $value")
    }
}

使用键保持稳定

为每个列表项提供稳定的 key，这样列表发生变化时 Compose 就能正确跟踪各项，从而改善性能和动画效果。

items(users, key = { it.id }) { user ->
    Text(user.name)
}

设置项间距

LazyColumn 接受 verticalArrangement 和 contentPadding，用于设置列表项之间的间距以及列表边缘的内边距。

LazyColumn(
    verticalArrangement = Arrangement.spacedBy(8.dp),
    contentPadding = PaddingValues(16.dp)
) {
    items(data) { Text(it) }
}

LazyRow

此外还有用于水平滚动列表的 LazyRow——接口相同，方向不同。它非常适合制作卡片轮播。

LazyRow {
    items(images) { img ->
        Image(painter = img, contentDescription = null)
    }
}

内置滚动

您不需要为 LazyColumn 添加滚动修饰符——它会自动滚动。添加 verticalScroll 会产生冲突并导致崩溃。延迟列表会自行处理滚动。

整合应用

一个包含标题、键和间距的列表。

@Composable
fun MessageList(messages: List<Message>) {
    LazyColumn(
        verticalArrangement = Arrangement.spacedBy(8.dp)
    ) {
        item { Text("Inbox") }
        items(messages, key = { it.id }) { msg ->
            Text(text = msg.text)
        }
    }
}

快速检查

与可滚动的 Column 相比，LazyColumn 的主要优势是什么？

回顾

LazyColumn：

  • 只构建可见项，适合较长的列表。
  • 使用 items() / itemsIndexed()，不要使用 for 循环。
  • 添加 key 以保持稳定；使用 item { } 添加标题。
  • 会自动滚动，无需滚动修饰符。LazyRow 是对应的水平版本。

常见问题解答

「使用 LazyColumn 构建列表」课时是免费的吗？

是的 — 「使用 LazyColumn 构建列表」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Android Academy 课程的其余内容，请升级到 CoddyKit PRO。 Android Academy 课程共包含 4 节课。

「使用 LazyColumn 构建列表」这节课中我会学到什么？

高效显示可滚动列表 你通过在浏览器中直接运行的动手代码来练习 Android Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Android Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Android Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。

「使用 LazyColumn 构建列表」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Android Academy 课中编写并运行代码吗？

能。每节 Android Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. Column、Row 和 Box
  2. Modifier 系统
  3. 对齐和排列
  4. 使用 LazyColumn 构建列表
← 返回 Android Academy