ArkTS 长列表用 LazyForEach:IDataSource 最小实现和三个容易踩的坑

举报
yd_236685256 发表于 2026/11/19 15:36:09 2026/11/19
【摘要】 在 HarmonyOS 应用里,列表数据少的时候直接用 ForEach 就够了;但一旦数据上千条,ForEach 会一次性创建全部子组件,首屏变慢、内存也上去。LazyForEach 的思路是按可视区域按需创建组件,滑出屏幕的组件可以被回收。本文记录我给一个长列表改造成 LazyForEach 的最小实现,以及实际调试中遇到的三个问题。 一、为什么 ForEach 在长列表里吃亏ForEac...

在 HarmonyOS 应用里,列表数据少的时候直接用 ForEach 就够了;但一旦数据上千条,ForEach 会一次性创建全部子组件,首屏变慢、内存也上去。LazyForEach 的思路是按可视区域按需创建组件,滑出屏幕的组件可以被回收。本文记录我给一个长列表改造成 LazyForEach 的最小实现,以及实际调试中遇到的三个问题。

一、为什么 ForEach 在长列表里吃亏

ForEach 会在首次渲染时为数组中的每一项都执行一次 itemGenerator。数据量是 2000 条时,就是 2000 个 ListItem 同时创建,即使屏幕上只能看到十几条。LazyForEach 只为可视区域(加上 cachedCount 指定的预加载数量)创建组件,这是两者最核心的区别。

二、IDataSource 的最小实现

LazyForEach 不接受普通数组,而是要求一个实现了 IDataSource 接口的数据源。接口里有四个方法:totalCount、getData、registerDataChangeListener、unregisterDataChangeListener。下面是一个可复用的基础类:

class BasicDataSource<T> implements IDataSource {
  private listeners: DataChangeListener[] = [];
  protected items: T[] = [];

  totalCount(): number {
    return this.items.length;
  }

  getData(index: number): T {
    return this.items[index];
  }

  registerDataChangeListener(listener: DataChangeListener): void {
    if (this.listeners.indexOf(listener) < 0) {
      this.listeners.push(listener);
    }
  }

  unregisterDataChangeListener(listener: DataChangeListener): void {
    const pos = this.listeners.indexOf(listener);
    if (pos >= 0) {
      this.listeners.splice(pos, 1);
    }
  }

  pushItem(item: T): void {
    this.items.push(item);
    this.listeners.forEach(l => l.onDataAdd(this.items.length - 1));
  }

  deleteItem(index: number): void {
    this.items.splice(index, 1);
    this.listeners.forEach(l => l.onDataDelete(index));
  }
}

页面里使用:

@Entry
@Component
struct MessageList {
  private source: BasicDataSource<string> = new BasicDataSource<string>();

  aboutToAppear(): void {
    for (let i = 0; i < 2000; i++) {
      this.source.pushItem(`消息 ${i}`);
    }
  }

  build() {
    List({ space: 8 }) {
      LazyForEach(this.source, (item: string) => {
        ListItem() {
          Text(item).fontSize(16).padding(12)
        }
      }, (item: string) => item)
    }
    .cachedCount(5)
    .width('100%')
    .height('100%')
  }
}

三、坑一:改了数据但界面不刷新

和 @State 修饰的数组不同,LazyForEach 的数据源变化不会被状态管理自动感知。直接修改 items 数组而不调用监听器的 onDataAdd、onDataDelete、onDataChange 等方法,界面不会更新。所以所有增删改都要收口到数据源类自己的方法里,在方法内部通知监听器,不要在页面里直接操作内部数组。

四、坑二:键值生成函数不稳定

LazyForEach 的第三个参数是键值生成函数,框架靠它判断哪些组件可以复用。我一开始写成了用 index 拼键值,结果在列表头部插入数据后,后面所有项的键都变了,框架认为全部是新数据,滚动时出现闪烁。键值应该来自数据本身的唯一标识,比如消息 id,而不是位置下标。示例里直接用字符串内容作键,前提是内容不重复;真实业务里建议用后端返回的 id。

另外要注意键值不能重复。重复的键会导致部分项不渲染或者渲染错位,排查时很难第一时间联想到是键的问题。

五、坑三:cachedCount 不是越大越好

cachedCount 表示在可视区域之外预先创建的列表项数量。设得太小,快速滑动时会看到空白;设得太大,又回到了"提前创建很多组件"的老问题,失去懒加载的意义。我的做法是先按一屏可见条数的一半左右设置,再在真机上快速滑动观察是否出现白块,逐步调整。列表项布局越复杂,越要谨慎增大这个值。

六、小结

  1. 数据量大时用 LazyForEach 替代 ForEach,按需创建组件。
  2. 数据源实现 IDataSource,所有数据变化都要通过监听器通知框架。
  3. 键值生成函数使用数据的稳定唯一标识,不要用下标。
  4. cachedCount 结合真机滑动效果调整,不要一味调大。

这几条在改造聊天记录、商品列表这类长列表页面时都适用。如果列表项里还有图片,建议再配合图片的尺寸约束和占位图,避免滑动过程中频繁重新布局。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。