前言在 ArkUI 状态管理体系中数据存储被分为三个层级AppStorage应用级内存存储、PersistentStorage持久化键值存储、LocalStorage页面级内存存储。这三个层级各有不同的作用范围、生命周期和适用场景合理选择它们直接决定了应用的数据一致性、持久化能力和性能表现。本文将以开源鸿蒙笔友通信应用 xiexin 的DataStore.ets为蓝本详细剖析这三个存储层级的语义、差异以及它们在实际开发中的选型策略。提示本文假设你已经了解 ArkUI 状态管理的基本概念。如果还不熟悉建议先阅读前十三篇文章。一、三级存储总览1.1 三个层级的核心差异维度AppStoragePersistentStorageLocalStorage存储位置应用进程内存磁盘文件页面实例内存生命周期应用进程存在持久化到存储页面实例存在作用范围整个应用整个应用单个页面及子组件数据持久化否进程重启丢失是重启后恢复否页面销毁丢失访问方式StorageLink/StoragePropPersistentStorage.persistPropLocalStorage实例典型用途用户信息、列表数据用户偏好、登录态页面内临时状态1.2 xiexin 当前的使用情况xiexin 当前只使用了AppStorage没有使用 PersistentStorage 和 LocalStorage// DataStore.ets — 仅使用 AppStorage static initializeData(): void { AppStorage.setOrCreatePenPal[](penPals, penPals); AppStorage.setOrCreateLetter[](letters, letters); AppStorage.setOrCreateUserProfile(userProfile, profile); AppStorage.setOrCreateWriteStats(writeStats, stats); AppStorage.setOrCreateInviteRecord[](invites, []); AppStorage.setOrCreateboolean(hasSeenSplash, false); AppStorage.setOrCreatenumber(currentTab, 0); }这种设计的局限是应用重启后所有数据丢失。xiexin 当前作为“纯演示“应用可以接受但如果要落地为真实产品必须引入 PersistentStorage 实现数据持久化。二、AppStorage应用级内存存储2.1 AppStorage 的核心特性AppStorage是应用启动时创建的单例对象在应用进程运行期间一直存在。// 写入 AppStorage.setOrCreate(key, value); // 不覆盖已有值 AppStorage.set(key, value); // 强制覆盖 // 读取 const value AppStorage.get(key); // 不存在返回 undefined // 删除 AppStorage.delete(key); // 清空 AppStorage.clear();2.2 AppStorage 的装饰器绑定// StorageLink双向绑定组件修改 → AppStorage 更新 StorageLink(penPals) penPals: PenPal[] []; // StorageProp单向绑定AppStorage → 组件组件修改不更新 AppStorage StorageProp(penPals) penPals: PenPal[] [];2.3 AppStorage 的最佳实践适用场景不适用场景页面间共享的数据页面内临时状态从网络加载的列表数据用户偏好设置需要跨组件同步的数据磁盘 IO 密集型数据数据量大但不频繁修改需要持久化的数据三、PersistentStorage持久化键值存储3.1 PersistentStorage 的核心特性PersistentStorage提供持久化键值存储能力数据会写入磁盘应用重启后可以恢复。import { PersistentStorage } from kit.ArkUI; // 持久化一个 key并关联到 AppStorage PersistentStorage.persistProp(hasSeenSplash, false); // 删除持久化 key PersistentStorage.deleteProp(hasSeenSplash); // 持久化后通过 AppStorage 访问 const hasSeenSplash AppStorage.getboolean(hasSeenSplash) ?? false;3.2 PersistentStorage 的工作原理graph LR subgraph 内存 AS[AppStorage: hasSeenSplash true] end subgraph 磁盘 PS[PersistentStorage] end AS --|持久化同步| PS当PersistentStorage.persistProp(hasSeenSplash, false)被调用后键hasSeenSplash被注册到 AppStorage如果磁盘中已有hasSeenSplash的值从磁盘恢复如果磁盘中还没有用默认值false初始化后续AppStorage.set(hasSeenSplash, true)会同步写入磁盘应用重启后AppStorage.get(hasSeenSplash)返回true3.3 PersistentStorage 的约束约束说明值类型限制仅支持number、string、boolean、Object及其数组不支持 class 实例不能持久化Observed类的实例最大 key 数量无明确限制但建议不超过 100 个同步写入持久化操作是同步的3.4 在 xiexin 中引入 PersistentStorage// 改造后的 DataStore.ets import { PersistentStorage } from kit.ArkUI; export class DataStore { static initializeData(): void { // 持久化的状态用 persistProp 注册 PersistentStorage.persistProp(hasSeenSplash, false); PersistentStorage.persistProp(currentTab, 0); PersistentStorage.persistProp(userProfile, JSON.stringify(new UserProfile())); // 非持久化的状态用 setOrCreate const penPals: PenPal[] DataStore.createMockPenPals(); AppStorage.setOrCreatePenPal[](penPals, penPals); const letters: Letter[] DataStore.createMockLetters(); AppStorage.setOrCreateLetter[](letters, letters); } }四、LocalStorage页面级内存存储4.1 LocalStorage 的核心特性LocalStorage是页面级的内存存储绑定到页面实例的生命周期。// 创建 LocalStorage 实例 const pageStorage new LocalStorage(); pageStorage.setOrCreate(pageTitle, 写信); // 在 Entry 组件中绑定 Entry(pageStorage) Component struct ComposePage { LocalStorageProp(pageTitle) pageTitle: string ; LocalStorageLink(draft) draft: string ; }4.2 LocalStorage 的装饰器绑定// LocalStorageProp单向绑定 LocalStorageProp(pageTitle) pageTitle: string ; // LocalStorageLink双向绑定 LocalStorageLink(draft) draft: string ;4.3 LocalStorage 的典型应用场景// 场景页面内多 Tab 共享状态 const pageStorage new LocalStorage(); pageStorage.setOrCreate(currentTab, 0); pageStorage.setOrCreate(searchQuery, ); // 页面组件 Entry(pageStorage) Component struct ComplexPage { LocalStorageProp(currentTab) currentTab: number 0; build() { Tabs({ index: this.currentTab }) { TabContent() { SearchTab() } TabContent() { BrowseTab() } } } } // 子组件共享同一个 LocalStorage Component struct SearchTab { LocalStorageLink(searchQuery) searchQuery: string ; build() { TextInput({ text: this.searchQuery }) .onChange((value: string) { this.searchQuery value; // 子组件修改父组件和其他子组件自动同步 }) } }五、三级存储选型决策树数据是否需要持久化 ├── 是 → PersistentStorage │ └── 数据是否需要跨页面共享 │ ├── 是 → 使用 persistProp 注册到 AppStorage │ └── 否 → 使用 AppStorage非持久化或持久化到文件 └── 否 → 数据是否需要跨页面共享 ├── 是 → AppStorage └── 否 → 数据是否需要跨子组件共享 ├── 是 → LocalStorage └── 否 → State 组件私有状态六、xiexin 的存储层改造建议6.1 当前状态分析xiexin 当前的数据存储需求数据当前存储是否需要持久化是否跨页面共享建议方案penPals笔友列表AppStorage是是PersistentStorage序列化letters信件列表AppStorage是是PersistentStorage序列化userProfile用户信息AppStorage是是PersistentStorageJSONwriteStats统计数据AppStorage是是从 letters 实时计算invites邀请记录AppStorage是是PersistentStorage序列化hasSeenSplash引导状态AppStorage是否PersistentStoragecurrentTabTab 索引AppStorage否是AppStorage6.2 改造后的 DataStoreimport { PersistentStorage } from kit.ArkUI; export class DataStore { static initializeData(): void { // 1. 持久化的原子状态 PersistentStorage.persistProp(hasSeenSplash, false); PersistentStorage.persistProp(currentTab, 0); // 2. 持久化的复杂对象序列化存储 const savedProfile AppStorage.getstring(saved_profile); if (!savedProfile) { const profile DataStore.createMockProfile(); PersistentStorage.persistProp(saved_profile, JSON.stringify(profile)); } // 反序列化回 AppStorage const profileStr AppStorage.getstring(saved_profile) ?? {}; const profile: UserProfile JSON.parse(profileStr); AppStorage.setOrCreateUserProfile(userProfile, profile); // 3. 非持久化的运行时数据 const penPals: PenPal[] DataStore.createMockPenPals(); AppStorage.setOrCreatePenPal[](penPals, penPals); const letters: Letter[] DataStore.createMockLetters(); AppStorage.setOrCreateLetter[](letters, letters); // 4. 从 letters 实时计算统计数据 const stats DataStore.computeStats(letters); AppStorage.setOrCreateWriteStats(writeStats, stats); } static addLetter(letter: Letter): void { // 原有逻辑不变 const letters: Letter[] AppStorage.getLetter[](letters) ?? []; letter.id letters.length 0 ? Math.max(...letters.map((l: Letter) l.id)) 1 : 1; letters.unshift(letter); AppStorage.setLetter[](letters, letters); // 同步更新笔友统计 const penPals: PenPal[] AppStorage.getPenPal[](penPals) ?? []; const idx penPals.findIndex((p: PenPal) p.id letter.penPalId); if (idx 0) { penPals[idx].totalLetters 1; penPals[idx].lastLetterAt letter.createdAt; penPals[idx].lastLetterPreview letter.body.substring(0, 30); penPals[idx].lastLetterStatus LetterStatus.WAITING_OTHER; penPals[idx].isLastLetterSender true; AppStorage.setPenPal[](penPals, penPals); } } }七、从 AppStorage 到 PersistentStorage 的迁移路径7.1 迁移步骤识别持久化需求确定哪些数据需要持久化注册 PersistentStorage key用persistProp注册序列化复杂对象Observed类实例需要序列化迁移数据把 AppStorage 中的数据同步到 PersistentStorage测试验证数据持久化是否正确7.2 序列化与反序列化// 写入时序列化 function savePenPals(penPals: PenPal[]): void { const json JSON.stringify(penPals); AppStorage.setstring(saved_penPals, json); } // 读取时反序列化 function loadPenPals(): PenPal[] { const json AppStorage.getstring(saved_penPals) ?? []; const data JSON.parse(json) as ArrayRecordstring, Object; return data.map((item) { const pal new PenPal(); Object.assign(pal, item); return pal; }); }八、LocalStorage 在 xiexin 中的应用8.1 场景ComposePage 的草稿管理xiexin 的 ComposePage 有 14 个State变量如果使用 LocalStorage 来管理草稿可以简化代码// 创建页面级 LocalStorage const composeStorage new LocalStorage(); composeStorage.setOrCreate(penPalId, -1); composeStorage.setOrCreate(body, ); composeStorage.setOrCreate(honorific, 尊敬的); composeStorage.setOrCreate(greeting, 您好); composeStorage.setOrCreate(closing, 此致\n敬礼); composeStorage.setOrCreate(paperStyle, PaperStyle.PLAIN); composeStorage.setOrCreate(wordCount, 0); Entry(composeStorage) Component struct ComposePage { LocalStorageProp(penPalId) selectedPenPalId: number -1; LocalStorageProp(body) body: string ; LocalStorageProp(honorific) honorific: string 尊敬的; LocalStorageProp(greeting) greeting: string 您好; LocalStorageProp(closing) closing: string 此致\n敬礼; LocalStorageProp(paperStyle) paperStyle: PaperStyle PaperStyle.PLAIN; LocalStorageProp(wordCount) wordCount: number 0; // ... 其他逻辑 }8.2 LocalStorage 与 AppStorage 的配合// 页面销毁时保存草稿到 AppStorage aboutToDisappear(): void { if (this.body.length 50) { AppStorage.setOrCreate(draft, { penPalId: this.selectedPenPalId, body: this.body, honorific: this.honorific, greeting: this.greeting, closing: this.closing, paperStyle: this.paperStyle, savedAt: Date.now() }); } }九、三级存储的性能对比9.1 读写性能存储层级读性能写性能说明AppStorage纳秒级纳秒级内存操作极快LocalStorage纳秒级纳秒级内存操作极快PersistentStorage微秒级微秒级磁盘 IO较慢9.2 内存占用AppStorage/LocalStorage数据在内存中占用应用进程内存PersistentStorage数据在磁盘上仅当被访问时加载到内存9.3 选型建议// 高频读写、不持久化 → AppStorage AppStorage.set(currentTab, index); // 低频读写、需要持久化 → PersistentStorage PersistentStorage.persistProp(hasSeenSplash, false); // 页面内共享、页面销毁可丢弃 → LocalStorage const pageStorage new LocalStorage(); pageStorage.setOrCreate(draft, );十、从 xiexin 看存储架构设计xiexin 当前的存储架构仅 AppStorage适合演示和原型阶段。如果要落地为真实应用建议按以下优先级改造短期1-2 周引入 PersistentStorage持久化hasSeenSplash和currentTab中期1-2 月引入 RDB 数据库替代数组存储的笔友和信件数据长期3-6 月引入分布式数据对象实现跨设备数据同步总结本文详细剖析了 HarmonyOS ArkUI 的 AppStorage/PersistentStorage/LocalStorage 三级存储的语义、差异和选型策略。xiexin 当前仅使用 AppStorage 的架构适合演示阶段但通过引入 PersistentStorage 和 LocalStorage可以显著提升数据持久化能力和页面隔离性。理解三级存储的关键是把握“三个维度“生命周期进程/持久化/页面、作用范围应用/页面、数据流向双向/单向。掌握了这三个维度就能在不同场景中选出最合适的存储方案。下一篇文章我们将深入 ForEach 列表渲染剖析键值策略与 Diff 算法的实现细节。如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力相关资源开源鸿蒙跨平台社区https://openharmonycrossplatform.csdn.netHarmonyOS AppStorage 全局状态https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-appstorageHarmonyOS PersistentStorage 持久化https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-persiststorageHarmonyOS LocalStorage 页面级存储https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-localstorageHarmonyOS 状态管理概述https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-state-management-overviewHarmonyOS 应用数据持久化https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-data-persistenceHarmonyOS 通过用户首选项实现持久化https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/data-persistence-by-preferencesHarmonyOS 分布式数据对象https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/data-sync-of-distributed-data-objectHarmonyOS 关系型数据库https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/data-persistence-by-rdb-store
企业数字化 ERP 产品动态
相关推荐
基于YOLOv12的条形码检测系统开发与实践 1. 项目概述这个基于YOLOv12的条形码检测系统是一个典型的计算机视觉应用项目,它整合了最新的目标检测算法、定制化数据集、用户交互界面和完整的项目架构。我在实际开发中发现,这类系统在零售库存管理、物流分拣、图书馆管理等场景中有着广泛的应用需求… · 2026/10/27 14:40:03
Visual C++运行库终极安装指南:5分钟解决所有Windows程序启动问题 Visual C运行库终极安装指南:5分钟解决所有Windows程序启动问题 【免费下载链接】vcredist AIO Repack for latest Microsoft Visual C Redistributable Runtimes 项目地址: https://gitcode.com/gh_mirrors/vc/vcredist
还在为Windows程序无法启动而烦恼吗&… · 2026/10/16 20:28:48
Cybercab自动驾驶仿真场景生成工具部署与使用指南 这次我们来看一个名为 Cybercab 的项目,它被不少开发者称为"艺术品"。这个项目在 GitHub 上开源,主要解决的是自动驾驶仿真测试中的场景生成和可视化问题。如果你在做自动驾驶算法开发、仿真测试或者需要快速构建复杂交通场景,Cybe… · 2026/11/8 11:30:14
安监局申电工证题千万别踩坑,南阳工程类毕业生怎么操作最稳妥 安监局申电工证题千万别踩坑,南阳工程类毕业生怎么操作最稳妥 你是不是也在网上刷到很多关于“安监局申电工证题”的信息,结果点进去全是广告和骗子?别急,今天咱们就聊聊怎么 千万别踩坑 ,从报名到考试,一步步教你搞定。… · 2026/11/20 22:53:27
旌阳区电工证怎么考?电子证书上岗必备!别等没证再后悔 旌阳区电工证怎么考?电子证书上岗必备!别等没证再后悔 我有个老乡,干了三年电工,工资一直上不去,直到他考了旌阳区电工证,才拿到正式电工岗位,工资翻了一倍。很多人和他一样, 急需特种作业证才能上岗找工作… · 2026/11/20 22:53:27
延安高压电工证哪里考怎么报名?怕考不过白交培训费的看过来 延安高压电工证哪里考怎么报名?怕考不过白交培训费的看过来 你是不是也这样,看到“延安高压电工证哪里考”几个字就心慌?怕报名费交了,考试又没通过,培训费打水漂?别急,今天我就从一个干了10年应急管理工作的人角度,给你讲讲延安高压电工证到底怎么… · 2026/11/20 22:53:27
旌阳区电工证怎么考?工地太忙根本没时间复习考试?教你高效拿证 旌阳区电工证怎么考?工地太忙根本没时间复习考试?教你高效拿证 工地太忙根本没时间复习考试,这是很多一线电工的真实写照。尤其是身处旌阳区的施工人员,想要考取【旌阳区电工证】,既担心考试难度,又担心【含金量】是否足够高,能带来实际收入的提升。其… · 2026/11/20 22:53:27
莱芜去哪里考电工证?避开中介陷阱的郑州报考避坑指南 莱芜去哪里考电工证?避开中介陷阱的郑州报考避坑指南 你是不是正为“莱芜去哪里考电工证”发愁?担心被中介坑钱、考不到正规证书?别慌,我这有份 郑州报考避坑指南 ,帮你理清楚整个流程,选对机构,省心又靠谱。 为什么电工证不能随便乱考?… · 2026/11/20 22:53:27
电工证要什么东西?通过率揭秘:转岗电工备考攻略全解析 电工证要什么东西?通过率揭秘:转岗电工备考攻略全解析 你急需特种作业证才能上岗找工作,但电工证要什么东西你还不清楚?别急,今天我们就来拆解电工证报考全流程,特别是针对安阳地区转岗从业者,告诉你电工证要什么东西、怎么准备、通过率有多高,以及备… · 2026/11/20 22:52:27
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 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驱动调试 /* 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 步进电机驱动实战解析 /* 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工业级双极步进电机控制方案 /* 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