ArkTS 长列表从 12 次掉帧到 60 帧:LazyForEach 三个坑
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` 只解决首帧、解决不了回滑。
- 点赞
- 收藏
- 关注作者
评论(0)