ArkTS 长列表从 12 次掉帧到 60 帧:LazyForEach 三个坑

举报
yd_236978410 发表于 2026/11/16 08:12:01 2026/11/16
【摘要】 ArkTS 长列表从 12 次掉帧到 60 帧:LazyForEach 三个坑一个商品流页面,3000 条数据,HarmonyOS NEXT(API 12)真机上滑到第 4 屏开始明显卡手。DevEco Profiler 的 Frame 面板抓到单帧最长 42ms,一屏滑完丢 12 帧。下面是我按顺序改掉的三处,改完同一条滑动路径 0 丢帧。坑一:ForEach 是"一次性全建",不是"按需...

ArkTS 长列表从 12 次掉帧到 60 帧:LazyForEach 三个坑

一个商品流页面,3000 条数据,HarmonyOS NEXT(API 12)真机上滑到第 4 屏开始明显卡手。DevEco Profiler 的 Frame 面板抓到单帧最长 42ms,一屏滑完丢 12 帧。下面是我按顺序改掉的三处,改完同一条滑动路径 0 丢帧。

坑一:ForEach 是"一次性全建",不是"按需建"

最初的写法是最常见的:


List() {
  ForEach(this.goodsList, (item: Goods) => {
    ListItem() { GoodsCard({ item: item }) }
  }, (item: Goods) => item.id.toString())
}

`ForEach` 在首帧就把 3000 个 ListItem 全部走一遍 build,只是没上屏。它的 key 生成函数解决的是"复用识别",不是"延迟构建"。于是首屏 42ms 那一帧里有 30ms 花在给 3000 个节点建 ArkTS 对象上。

换成 `LazyForEach` + 自己实现 `IDataSource`:


class GoodsDataSource implements IDataSource {
  private listeners: DataChangeListener[] = []
  private data: Goods[] = []
  totalCount(): number { return this.data.length }
  getData(index: number): Goods { return this.data[index] }
  registerDataChangeListener(l: DataChangeListener) { this.listeners.push(l) }
  unregisterDataChangeListener(l: DataChangeListener) {
    const i = this.listeners.indexOf(l)
    if (i >= 0) this.listeners.splice(i, 1)
  }
}

注意 `getData` 里不要做 `JSON.parse` 或 `new Goods(...)`。我第一版在 `getData` 里把 Map 转成对象,滚动时每帧调用十几次,等于又回到老问题。数据在 setData 时一次性整理好,`getData` 只做数组下标取值。

坑二:cachedCount 默认太小,回滑就重建

`LazyForEach` 只建可见区域,滑出屏幕的节点立刻销毁。往回滑一格就要重建,实测回滑方向掉帧比正向更严重。

`List` 上加 `cachedCount(3)`:


List() {
  LazyForEach(this.ds, (item: Goods) => {
    ListItem() { GoodsCard({ item: item }) }
  }, (item: Goods) => item.id.toString())
}
.cachedCount(3)

`cachedCount` 是"可视区外额外保留的 item 数",不是像素。设 3 之后同一条滑动路径掉帧从 12 降到 3,代价是首屏内存从 118MB 涨到 126MB(Profiler 的 Memory 面板读数)。设 5 时内存 141MB,掉帧没有再降,所以 3 是这台机器的拐点,不必照搬别人的值。

坑三:@Reusable 复用时状态不重置,出现"旧图串新数据"

第三个坑不是性能问题,是正确性问题,但它是开启复用的必然结果。

给 item 组件加 `@Reusable`、页面里加 `.reuseId('goodsCard')` 之后,滑动时偶尔看到第 7 条的位置显示第 3 条的价格。原因是组件实例被复用,`@State` 里上一份数据没有被覆盖——我在 `aboutToAppear` 里请求图片,`aboutToReuse` 只写了 `this.item = params.item`,但图片的 `alt` 文案和"已收藏"标记留在旧值上。

正确做法是把所有派生状态都在 `aboutToReuse` 里显式重置:


@Reusable
@Component
struct GoodsCard {
  @State item: Goods = new Goods()
  @State favorited: boolean = false
  @State imgAlt: string = ''

  aboutToReuse(params: Record<string, Object>) {
    this.item = params.item as Goods
    this.favorited = false        // 必须显式重置,复用不会自动清
    this.imgAlt = ''
  }
}

另外 `aboutToAppear` 里起的定时器、注册的 `emitter` 监听,在 `aboutToDisappear` 里一定要反注册,否则复用后回调会打到已销毁的实例上。我在 Profiler 里看到过一次"未知组件 setState"告警,就是这个引起的。

结果

同一台真机、同一条滑动路径(首屏 → 底部 → 回滑三次):

| 阶段 | 最长帧 | 丢帧数 |

|---|---|---|

| ForEach 全量 | 42ms | 12 |

| 换 LazyForEach | 28ms | 7 |

| + cachedCount(3) | 19ms | 3 |

| + @Reusable 且状态全重置 | 16ms | 0 |

留两条经验:一是先用 Profiler 的 Frame 面板定位到"哪一帧超 16.7ms",再去改代码,不要凭手感加缓存;二是 `cachedCount` 与 `@Reusable` 都要用,只上 `LazyForEach` 只解决首帧、解决不了回滑。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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