跨平台开发 / 系统课时

用 SliverList 构建长列表

用 SliverList 构建长列表

当普通 ListView 面对复杂滚动页面或大量数据时,完整构建子组件会带来性能压力。本篇将使用 SliverList 替代普通列表,理解懒加载构建机制,并掌握在 CustomScrollView 中组织长列表的方法。

学习目标

  • 理解 SliverList 与普通 ListView 在构建方式上的区别。
  • 掌握 SliverChildBuilderDelegate 创建高性能长列表。
  • 能够在复杂滚动页面中合理使用 SliverList。

SliverList 解决的问题

Flutter 的普通 ListView 适合单一区域滚动,但真实应用中经常需要把顶部头图、吸顶区域、列表内容组合到同一个滚动容器中。此时使用 Sliver 系列组件可以让多个滚动区域共享同一个滚动计算过程。

SliverList 是 CustomScrollView 中的列表型 Sliver,它不会一次性创建所有子组件,而是在滚动过程中根据可见区域动态构建需要显示的项目。

这种方式特别适合新闻流、商品列表、消息记录等数量较大的动态数据场景。

使用 SliverList 创建懒加载列表

SliverList 通常配合 SliverChildBuilderDelegate 使用。Builder 会在某个列表项进入可见范围附近时调用构建方法,而不是立即生成整个列表。

下面示例展示一个完整的 Flutter 页面:

dart
import 'package:flutter/material.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: CustomScrollView(
          slivers: [
            SliverAppBar(
              pinned: true,
              title: const Text('消息列表'),
            ),
            SliverList(
              delegate: SliverChildBuilderDelegate(
                (context, index) {
                  // 只构建当前需要显示的列表项
                  return ListTile(
                    title: Text('消息 $index'),
                  );
                },
                childCount: 1000,
              ),
            ),
          ],
        ),
      ),
    );
  }
}

预期结果

text
运行应用后显示一个可滚动页面。
顶部 AppBar 会保持固定,大量消息项可以连续滚动浏览。

这里的关键不是列表数量本身,而是 SliverChildBuilderDelegate 提供的按需构建能力。当列表包含数千甚至更多数据时,这种方式可以减少初始布局和内存占用。

SliverList 与 ListView 的选择

两者都可以创建滚动列表,但适用范围不同。

场景 推荐组件
单独一个列表页面 ListView
多个滚动区域组合 SliverList
需要头部、网格、列表混排 CustomScrollView + Sliver
超长动态数据 SliverList + Builder

如果页面只是展示简单列表,没有其他 Sliver 组件需求,继续使用 ListView 会更直接。只有当页面需要组合多个滚动结构时,才需要引入 SliverList。

使用时的性能注意点

SliverList 虽然支持懒加载,但列表项本身的复杂度仍然影响性能。每个 item 都应该保持轻量,避免在构建方法中执行耗时计算或重复创建大型对象。

常见优化方式包括:

  • 使用稳定的 Key 管理动态变化的列表项。
  • 避免在 builder 中访问大量外部状态。
  • 将复杂列表项拆分为独立 Widget,减少重建范围。

对于需要分页加载的数据,SliverList 通常与状态管理和滚动监听结合,在接近底部时加载下一批数据。

当一个页面需要同时承载多个内容区域,并且列表数据可能持续增长时,SliverList 是比普通列表更合适的基础组件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 SliverList 构建长列表

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通