HarmonyOS开发者社区

Repeat是鸿蒙从API version 12开始引入的新一代循环渲染组件，相比ForEach有显著优势。第一，Repeat内置了更智能的diff算法——当数据源发生变化时，它能精确识别出哪些项是新增、删除、移动或修改的，并只更新受影响的UI组件，而ForEach的diff能力较弱，容易导致全量重建。第二，Repeat天然支持组件复用——配合@ReusableV2使用，性能远超ForEach。第三，Repeat提供了更灵活的模板定义——支持template机制，可以为不同类型的数据项渲染不同的UI模板。第四，Repeat的键值生成是强制的且类型安全的，避免了ForEach中因省略键值导致的性能陷阱。在长列表场景下，Repeat的滑动帧率比ForEach高出约30%-50%，内存占用更低。因此，新项目应优先使用Repeat，存量项目也建议逐步迁移。需要注意的是，Repeat需要配合@ComponentV2使用，不支持V1状态管理。

// ForEach写法（不推荐用于长列表）
ForEach(this.items, (item: Item, index: number) => {
ListItem() { ItemCard({ data: item }) }
}, (item: Item) => item.id) // 必须提供键值

// Repeat写法（推荐）
@ComponentV2
struct RepeatDemo {
@Local items: Item[] = [];

build() {
List() {
Repeat(this.items)
.each((obj: RepeatItem<Item>) => {
ListItem() {
ItemCard({ data: obj.item })
}.reusable(true) // 开启组件复用
})
.key((item: Item) => item.id) // 键值生成函数
.virtualScroll(true) // 开启虚拟滚动，性能更优
}
}
}