首页/新闻资讯/正文详情

HarmonyOS开发实战:笔友-ForEach 列表渲染键值策略与 Diff 算法

发布时间:2026/11/20 23:59:57 来源:云帆数科 栏目:资讯中心
HarmonyOS开发实战:笔友-ForEach 列表渲染键值策略与 Diff 算法
前言在 ArkUI 声明式开发范式中列表渲染是最常见的 UI 模式之一。ForEach是 ArkUI 提供的核心列表渲染 API它根据数据数组循环生成一组组件。但ForEach的键值生成策略直接决定了列表 Diff 算法的效率和正确性。本文将以开源鸿蒙笔友通信应用 xiexin 的Index.ets和ReadLetterPage.ets为蓝本详细剖析ForEach的键值策略、Diff 算法原理、常见陷阱以及在不同场景下的最佳实践。提示本文假设你已经了解 ArkUI 声明式开发的基本概念。如果还不熟悉建议先阅读前十四篇文章。一、ForEach 的基本用法1.1 ForEach 的三个参数ForEach接受三个参数ForEach( arr: any[], // 数据数组 itemGenerator: (item: any, index?: number) void, // 子项生成函数 keyGenerator?: (item: any, index?: number) string // 键值生成函数 )1.2 xiexin 中的 ForEach 使用xiexin 的Index.ets中多处使用了ForEach// 信箱 Tab信件列表 ForEach(this.getSortedLetters(), (letter: Letter) { this.LetterCard(letter) }, (letter: Letter) letter.id.toString()) // 笔友 Tab笔友列表 ForEach(this.penPals, (pal: PenPal) { this.PenPalCard(pal) }, (pal: PenPal) pal.id.toString())1.3 ForEach 渲染流程graph LR A[数据数组] --|keyGenerator| B[生成键值表] B -- C[Diff 算法] D[已有 UI 树] -- C C -- E[更新 UI 树]二、键值生成策略2.1 为什么需要键值键值Key是 ForEach 进行 Diff 算法的依据。当数据数组发生变化时ArkUI 通过键值来判断哪些项是“新增“、“删除“或“移动“的。2.2 键值的选择// 正确使用唯一 ID (letter: Letter) letter.id.toString() // 正确使用数组索引仅当数组不变时 (letter: Letter, index: number) index.toString() // 错误使用不稳定值 (letter: Letter) letter.body.substring(0, 5) // 内容变化会导致键值变化 // 错误使用固定字符串 (letter: Letter) letter // 所有项键值相同Diff 失效2.3 xiexin 的键值策略xiexin 使用letter.id.toString()和pal.id.toString()作为键值// 信件列表使用 letter.id 作为键值 ForEach(this.getSortedLetters(), (letter: Letter) { this.LetterCard(letter) }, (letter: Letter) letter.id.toString()) // 笔友列表使用 pal.id 作为键值 ForEach(this.penPals, (pal: PenPal) { this.PenPalCard(pal) }, (pal: PenPal) pal.id.toString())这是推荐的做法因为id是持久化的唯一标识不会变化每个id对应一个信件/笔友永远不会重复即使数组排序变化键值不变ArkUI 能正确复用组件三、ForEach 的 Diff 算法3.1 Diff 算法原理当数据数组变化时ForEach 的 Diff 算法执行以下步骤// 假设初始数组 const letters [ { id: 1, title: 信1 }, { id: 2, title: 信2 }, { id: 3, title: 信3 } ]; // 更新后的数组 const newLetters [ { id: 4, title: 信4 }, // 新增 { id: 1, title: 信1 }, // 保留 { id: 3, title: 信3 } // 保留 ];Diff 过程遍历旧键值表[1, 2, 3]遍历新键值表[4, 1, 3]发现2不存在于新表中 → 删除{ id: 2 }的组件发现4不存在于旧表中 → 新增{ id: 4 }的组件1和3都存在 → 复用组件更新数据3.2 键值对 Diff 的影响// 情况 1键值稳定Diff 高效 ForEach(this.penPals, (pal: PenPal) { this.PenPalCard(pal) }, (pal: PenPal) pal.id.toString()) // 稳定键值 // 情况 2键值不稳定Diff 低效 ForEach(this.penPals, (pal: PenPal) { this.PenPalCard(pal) }, (pal: PenPal) Math.random().toString()) // 每次重新生成键值所有组件销毁重建键值策略Diff 效果组件复用唯一 ID精确 diff全部复用数组索引头部插入准确尾部插入准确随机值全部销毁重建不复用相同值无法 diff全部复用但数据错乱四、ForEach 与 getSortedLetters()xiexin 的Index.ets中有一个有趣的设计getSortedLetters()方法对信件进行排序然后把排序后的结果传给ForEach// 排序信件 - 待回信置顶 private getSortedLetters(): Letter[] { const sorted: Letter[] [...this.letters]; sorted.sort((a: Letter, b: Letter) { // 待回信的排前面 const aUrgent (!a.isSender a.status LetterStatus.WAIT_REPLY) ? 0 : 1; const bUrgent (!b.isSender b.status LetterStatus.WAIT_REPLY) ? 0 : 1; if (aUrgent ! bUrgent) { return aUrgent - bUrgent; } return b.createdAt - a.createdAt; }); return sorted; } // ForEach 中使用排序后的数组 ForEach(this.getSortedLetters(), (letter: Letter) { this.LetterCard(letter) }, (letter: Letter) letter.id.toString())4.1 排序对 Diff 的影响当StorageProp(letters)变化时getSortedLetters()返回一个新数组但letter.id键值不变所以排序导致的数组顺序变化 → 键值表变化 → ArkUI 重新排列组件letter.status变化导致排序优先级变化 → 键值顺序变化 → ArkUI 移动组件新增信件 → 新增键值 → ArkUI 新增组件由于 xiexin 使用letter.id作为键值排序变化不会影响组件复用率。4.2 展开运算符的拷贝[...this.letters]创建了一个新数组这是必要的因为sort()会修改原数组// 错误直接排序会修改 StorageProp 数组 this.letters.sort(...); // 修改了 AppStorage 中的源数据 // 正确先拷贝再排序 const sorted: Letter[] [...this.letters]; sorted.sort(...); // 不影响源数据五、ForEach 的常见陷阱5.1 键值重复// 错误键值重复 ForEach(this.penPals, (pal: PenPal) { this.PenPalCard(pal) }, (pal: PenPal) same_key) // 所有项的键值相同 // 错误键值可能重复 ForEach(this.penPals, (pal: PenPal) { this.PenPalCard(pal) }, (pal: PenPal) pal.name) // 同名笔友会导致键值重复5.2 键值不稳定// 错误键值不稳定 ForEach(this.penPals, (pal: PenPal) { this.PenPalCard(pal) }, (pal: PenPal) Date.now().toString()) // 每次渲染键值不同5.3 在 ForEach 中修改数组// 错误在 ForEach 中直接修改数组 ForEach(this.penPals, (pal: PenPal) { Button(删除).onClick(() { this.penPals.splice(0, 1); // 直接修改数组会引发渲染问题 }) }, (pal: PenPal) pal.id.toString()) // 正确创建新数组 ForEach(this.penPals, (pal: PenPal) { Button(删除).onClick(() { this.penPals this.penPals.filter((p: PenPal) p.id ! pal.id); }) }, (pal: PenPal) pal.id.toString())5.4 ForEach 与 Builder 的配合// 正确在 ForEach 中调用 Builder 函数 ForEach(this.penPals, (pal: PenPal) { this.PenPalCard(pal) }, (pal: PenPal) pal.id.toString()) // 错误在 ForEach 中使用独立组件时需要传递 ObjectLink ForEach(this.penPals, (pal: PenPal) { PenPalCard({ pal: pal }) // 组件形式 }, (pal: PenPal) pal.id.toString())六、ForEach vs LazyForEach6.1 核心差异维度ForEachLazyForEach渲染策略一次性渲染所有项按需渲染可见项适用数据量 100 项100 项以上内存占用全部加载仅加载可见项 缓存滚动性能数据量大时下滑数据量大时流畅实现复杂度简单需要实现 DataSource6.2 选型决策// 数据量小 100 项→ ForEach ForEach(this.penPals, (pal: PenPal) { this.PenPalCard(pal) }, (pal: PenPal) pal.id.toString()) // 数据量大 100 项→ LazyForEach LazyForEach(this.penPalsDataSource, (pal: PenPal) { this.PenPalCard(pal) }, (pal: PenPal) pal.id.toString())七、ForEach 的渲染性能优化7.1 避免在 ForEach 中执行耗时操作// 反例在 itemGenerator 中执行耗时计算 ForEach(this.penPals, (pal: PenPal) { this.PenPalCard(pal) // 耗时的计算 }, (pal: PenPal) pal.id.toString())7.2 使用 Builder 拆分// 优化把 UI 拆分到 Builder 中 ForEach(this.penPals, (pal: PenPal) { this.PenPalCard(pal) // Builder 函数 }, (pal: PenPal) pal.id.toString())7.3 减少不必要的 ForEach 重渲染// 反例每次渲染都创建新数组 ForEach(this.getSortedLetters(), (letter: Letter) { this.LetterCard(letter) }, (letter: Letter) letter.id.toString()) // 优化缓存排序结果 private sortedLetters: Letter[] []; private getSortedLetters(): Letter[] { if (this.sortedLetters.length ! this.letters.length) { this.sortedLetters [...this.letters]; this.sortedLetters.sort(/* ... */); } return this.sortedLetters; }八、ForEach 在 xiexin 中的性能分析8.1 当前数据量xiexin 当前的数据量笔友列表3 个mock 数据信件列表4 个mock 数据在这种数据量下ForEach的性能完全不是问题。但考虑未来扩展笔友列表最多 50 个信件列表可能几百个8.2 性能瓶颈预测当信件列表增长到 1000 时ForEach可能面临以下问题首帧渲染慢一次性渲染 1000 个组件内存占用高1000 个组件的 UI 树滚动卡顿每次重渲染都需要遍历所有组件8.3 优化建议// 当前适用于小数据量 ForEach(this.getSortedLetters(), (letter: Letter) { this.LetterCard(letter) }, (letter: Letter) letter.id.toString()) // 优化适用于大数据量 LazyForEach(this.lettersDataSource, (letter: Letter) { this.LetterCard(letter) }, (letter: Letter) letter.id.toString())九、ForEach 的扩展实践9.1 嵌套 ForEach// 嵌套 ForEach 渲染二级列表 Builder renderPenPalGroup(group: { stage: string, pals: PenPal[] }) { Column({ space: 12 }) { Text(group.stage).fontSize(18).fontWeight(FontWeight.Bold) ForEach(group.pals, (pal: PenPal) { this.PenPalCard(pal) }, (pal: PenPal) pal.id.toString()) } } // 外层 ForEach ForEach(this.penPalGroups, (group: { stage: string, pals: PenPal[] }) { this.renderPenPalGroup(group) }, (group: { stage: string, pals: PenPal[] }) group.stage)9.2 多列 ForEach// 使用 Grid 实现多列渲染 Grid() { ForEach(this.penPals, (pal: PenPal) { GridItem() { this.PenPalCard(pal) } }, (pal: PenPal) pal.id.toString()) } .columnsTemplate(1fr 1fr) .columnsGap(12) .rowsGap(12)十、从 xiexin 看 ForEach 设计xiexin 的ForEach使用体现了“简单、正确“的原则使用唯一 ID 作为键值letter.id.toString()和pal.id.toString()通过Builder函数渲染子项保持itemGenerator简洁排序在外部完成getSortedLetters()先排序再传给 ForEach不修改原数组[...this.letters]拷贝后再排序这些做法虽然简单但确保了 ForEach 的正确性和可维护性。总结本文详细剖析了 HarmonyOS ArkUI 的ForEach列表渲染机制重点讲解了键值生成策略、Diff 算法原理、常见陷阱以及在不同场景下的最佳实践。理解 ForEach 的关键是把握“一个核心、三个原则“一个核心是键值策略键值决定了 Diff 的效率和正确性三个原则是唯一性、稳定性、永久性——键值必须唯一、稳定且永久不变。下一篇文章我们将深入LazyForEach懒加载剖析长列表的性能优化实践。如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力相关资源开源鸿蒙跨平台社区https://openharmonycrossplatform.csdn.netHarmonyOS ForEach 渲染控制https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-rendering-control-foreachHarmonyOS LazyForEach 渲染控制https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-rendering-control-lazyforeachHarmonyOS List 组件https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-components/ListHarmonyOS Grid 组件https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-components/GridHarmonyOS 高性能编程实践https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-high-performance-programmingHarmonyOS 组件复用开发实践https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-component_reuseHarmonyOS Reusable 组件复用https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-reusableHarmonyOS 状态管理概述https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-state-management-overview

相关推荐

通过taotoken cli一键配置团队开发环境统一模型接入点
通过taotoken cli一键配置团队开发环境统一模型接入点

通过taotoken cli一键配置团队开发环境统一模型接入点 在团队协作开发中,统一大模型API的接入点和管理API密钥是提升效率与安全性的关键环节。手动为每个成员、每台机器、每个工具逐一配置不仅耗时,还容易因配置不一致导致调用失败或密钥泄露风险。Taot… · 2026/11/20 23:59:55

观测不同模型在Taotoken平台上的实际响应表现
观测不同模型在Taotoken平台上的实际响应表现

观测不同模型在Taotoken平台上的实际响应表现 当你在开发中需要调用大模型时,面对众多模型选项,一个常见的疑问是:不同模型的实际响应速度和资源消耗究竟如何?直接去各家厂商的官方文档查看技术规格是一种方式,但在统… · 2026/11/18 6:12:56

揭秘Attention机制的5大认知误区:90%工程师都踩过的坑及避坑指南
揭秘Attention机制的5大认知误区:90%工程师都踩过的坑及避坑指南

更多请点击: https://codechina.net 第一章:Attention机制的本质与起源 Attention机制并非深度学习的“新发明”,而是对人类认知过程的数学建模——它模拟了大脑在处理海量信息时动态分配有限认知资源的能力。其本质是一种**加权聚合函数**&… · 2026/11/15 3:24:20

莱阳电工证报考条件内部消息:别再被坑!这5步教你搞定电工证
莱阳电工证报考条件内部消息:别再被坑!这5步教你搞定电工证

莱阳电工证报考条件内部消息:别再被坑!这5步教你搞定电工证 现在找工作,没个电工证根本没人搭理!尤其是在建筑工地、工厂、电力公司这些地方,电工证就是你的敲门砖。可偏偏很多人连莱阳电工证报考条件都不清楚,光凭一张嘴说自己会电工,那只能白忙一场… · 2026/11/20 23:59:17

考电工证体检几项最新政策解读 全国通用证书怎么复审
考电工证体检几项最新政策解读 全国通用证书怎么复审

考电工证体检几项最新政策解读 全国通用证书怎么复审 证书过期了不知道怎么复审延期?别慌,这篇文章给你讲明白。尤其是手里拿着低压电工证、高压电工证的你,如果还没搞清楚体检项目和复审流程,那真的要吃大亏。别让一张全国通用的电工证变成“废纸”,赶… · 2026/11/20 23:59:17

电工证原价多久拿证?别再被中介忽悠了
电工证原价多久拿证?别再被中介忽悠了

电工证原价多久拿证?别再被中介忽悠了 你是不是也遇到过这种情况?明明是想考个电工证,结果被各种培训机构、中介绕得晕头转向,价格也五花八门,到底哪一家靠谱?更头疼的是, 多久拿证 成了你最大的疑问,生怕耽误了工期和项目进度。… · 2026/11/20 23:59:17

电工证牌照过期了不知道怎么复审延期?内部消息来了
电工证牌照过期了不知道怎么复审延期?内部消息来了

电工证牌照过期了不知道怎么复审延期?内部消息来了 证书过期了不知道怎么复审延期?你不是一个人。最近很多在工地、工厂一线干活的电工朋友都在问这个问题,尤其是在 鹤壁 这样的水利工程建设地,特种作业证的 复审流程 和 地区差异… · 2026/11/20 23:59:17

低压电工证是四级吗?含金量高不高?工地电工必看
低压电工证是四级吗?含金量高不高?工地电工必看

低压电工证是四级吗?含金量高不高?工地电工必看 工地太忙根本没时间复习考试,低压电工证是四级吗?含金量高不高?这些问题困扰着很多一线电工,尤其是那些在安阳市政公用工程单位工作的同事。今天咱们就来掰扯清楚,低压电工证到底是几级、含金量如何,还… · 2026/11/20 23:59:17

电工证考试科四通过率揭秘:学历不高也能报上名
电工证考试科四通过率揭秘:学历不高也能报上名

电工证考试科四通过率揭秘:学历不高也能报上名 你是不是也担心自己学历不够,考不了电工证?别急,今天就带你扒一扒【电工证考试科四】的真实通过率,让你明白, 学历不高怕报不上名 其实是个误区。… · 2026/11/20 23:58:17

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32

建设厅特种工周三报名怎么弄?上岗必备别被中介坑
建设厅特种工周三报名怎么弄?上岗必备别被中介坑

建设厅特种工周三报名怎么弄?上岗必备别被中介坑 不知道去哪报名怕被中介坑?作为商丘某高校工程类应届毕业生,小李最近就遇到了这样的困扰。他刚毕业,正在找实习岗位,发现很多工地都要求持有特种作业操作证,尤其是【建设厅特种工周三报名】这个时间点,… · 2026/11/20 0:00:54

中专考的中级电工证内部消息全攻略
中专考的中级电工证内部消息全攻略

中专考的中级电工证内部消息全攻略 你中专毕业,手头有中级电工证,但不知道从哪开始报名,怕被中介坑?别急,这篇文章就是为你量身定制的“内部消息”,帮你避开报名陷阱,稳稳拿到证书。… · 2026/11/20 0:00:54

外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价
外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价

外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价 之前考的证在外省能不能转过来?这几乎是所有在外地打拼的电工从业者最关心的问题。特别是像洛阳这样的工业城市,很多电工证是在外地考的,现在想在当地用,流程是不是很复杂?其实,只要搞清楚… · 2026/11/20 0:00:54

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:45

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:54

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:26:03

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码