ArkUI 长列表性能优化实战:LazyForEach 与 @Reusable 组件复用

举报
yd_277938722 发表于 2026/11/16 10:25:28 2026/11/16
【摘要】 一、问题从哪来在做信息流、消息列表或通讯录这类长列表页面时,很多人会先撞上一个共同的现象:数据量一旦到上千条,进入页面的白屏时间明显变长,滑动开始掉帧,内存曲线持续上涨。排查下去,问题往往既不在网络请求,也不在图片解码,而在于用 ForEach 直接把整个列表渲染了出来。ForEach 的语义是全量渲染。页面创建时,它会把数据源里的每一条数据都实例化成组件;数据变更时,再按 key 做一次...

一、问题从哪来

在做信息流、消息列表或通讯录这类长列表页面时,很多人会先撞上一个共同的现象:数据量一旦到上千条,进入页面的白屏时间明显变长,滑动开始掉帧,内存曲线持续上涨。排查下去,问题往往既不在网络请求,也不在图片解码,而在于用 ForEach 直接把整个列表渲染了出来。

ForEach 的语义是全量渲染。页面创建时,它会把数据源里的每一条数据都实例化成组件;数据变更时,再按 key 做一次完整比对。条目少的时候没有任何感觉,上千条就足以把主线程压垮。正确的做法是换成 LazyForEach:它只创建可视区域以及少量缓存区内的组件,滑出屏幕的组件被回收,滑入时按需构建,从根本上减少了同一时刻存在的组件数量。

二、LazyForEach 需要一个数据源

LazyForEach 不接受普通数组,它要求传入一个实现了 IDataSource 接口的数据源对象。这个接口很朴素:totalCount 返回条目总数,getData 按索引取数据,再加上一对注册与注销数据变更监听的方法。下面是一个最小可用实现。

class BasicDataSource implements IDataSource {
  private listeners: DataChangeListener[] = [];
  private dataArray: Item[] = [];

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

  public getData(index: number): Item {
    return this.dataArray[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);
    }
  }

  public addData(index: number, item: Item): void {
    this.dataArray.splice(index, 0, item);
    this.listeners.forEach((listener: DataChangeListener) => {
      listener.onDataAdd(index);
    });
  }
}

页面里使用的时候,把它交给 List,并注意第三个参数是 key 生成器。

List({ space: 8 }) {
  LazyForEach(this.source, (item: Item) => {
    ListItem() {
      ItemView({ item: item })
    }
  }, (item: Item) => item.id)
}
.cachedCount(3)

三、两个容易被忽略的参数

第一个是 key 生成器。它必须返回稳定且全局唯一的字符串。用数组下标当 key 是最常见的错误:在列表头部插入或删除一条之后,后面所有条目的 key 会整体平移,框架会认为这些组件"换了身份",于是把旧组件销毁、新组件重建。表现出来的现象是插入一条数据后整屏闪一下,滚动位置也跟着乱。

第二个是 cachedCount,它决定屏幕之外预加载多少条。设得太小,快速滑动时会出现空白占位;设得太大,内存占用又会回升。一般从 2 到 3 起步,再按条目的复杂程度微调。

四、组件复用解决另一件事

LazyForEach 解决的是"少建",而 @Reusable 解决的是"重建"。列表项组件加上 @Reusable 装饰器之后,滑出屏幕的组件实例不会立即销毁,而是进入复用池;滑入时直接把旧实例拿来用,并在 aboutToReuse 回调里接收新的数据。

@Reusable
@Component
struct ItemView {
  @State item: Item = new Item();
  @State expanded: boolean = false;

  aboutToReuse(params: Record<string, Object>): void {
    this.item = params.item as Item;
    this.expanded = false;
  }

  build() {
    Column() {
      Text(this.item.title)
        .fontSize(16)
      if (this.expanded) {
        Text(this.item.detail)
          .fontSize(14)
      }
    }
    .onClick(() => {
      this.expanded = !this.expanded;
    })
  }
}

这里有个必须记住的坑:复用组件内部的 @State 不会被自动重置。假如列表项带"展开/收起"这种交互状态,复用之后会带着上一条的状态出现,用户看到的就是"点开一条,另一条也自己展开了"。解决办法只有一个,在 aboutToReuse 里把它显式归零。

五、数据变了要主动通知

直接对内部数组做 push 或修改,UI 是不会刷新的,因为框架并不知道数据源变了。必须通过监听回调把变更告诉 LazyForEach:新增调用 onDataAdd,修改调用 onDataChange,删除调用 onDataDelete,批量重载才用 onDataReloaded。onDataReloaded 会让整段列表重建,能不用就不用。

六、还有几个常见坑

LazyForEach 必须直接放在 List、Grid、Swiper 这类滚动容器内部,如果被包在 if 条件渲染里,懒加载会失效,退化成一次性全建。嵌套滚动也要谨慎,内层滚动容器会抢走手势,导致外层列表拖不动。

七、改造后的实际感受

同一个千条级别的消息列表,从 ForEach 换成 LazyForEach 并给列表项加上 @Reusable 之后,进入页面基本看不到白屏,长距离快速滑动不再出现明显掉帧,内存占用随滑动趋于平稳而不是一路上涨。具体收益与设备性能、条目复杂度强相关,不建议直接套用别人的数字,最好用 DevEco Studio 的性能分析工具在自己的工程里做前后对比。

八、小结

长列表卡顿不是玄学:先用 LazyForEach 把"全量创建"改成"按需创建",再用 @Reusable 把"反复重建"改成"实例复用",最后保证数据变更走通知、key 保持稳定唯一,三个动作做到位,绝大多数列表性能问题都会消失。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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