鸿蒙待办清单本地持久化:Preferences 防丢数据的三个要点

举报
yd_283113804 发表于 2026/11/15 00:38:30 2026/11/15
【摘要】 做鸿蒙待办清单时,最容易被低估的一环是本地持久化。云同步再完善,本地数据一旦重启就丢,用户第一反应也是“App 不可靠”。我最近在待办清单案例里反复验证后,总结出三条最关键的做法。 一、put 之后必须 flush,否则只是写进内存Preferences 的 put() 只把数据写进内存缓存,不会立即落盘。只有显式调用 preferences.flush(),数据才会真正写入磁盘文件。如果只...

做鸿蒙待办清单时,最容易被低估的一环是本地持久化。云同步再完善,本地数据一旦重启就丢,用户第一反应也是“App 不可靠”。我最近在待办清单案例里反复验证后,总结出三条最关键的做法。

一、put 之后必须 flush,否则只是写进内存

Preferences 的 put() 只把数据写进内存缓存,不会立即落盘。只有显式调用 preferences.flush(),数据才会真正写入磁盘文件。如果只 put 不 flush,应用被系统杀掉或设备重启后,内存缓存丢失,数据就没了。

正确的做法是每次增删改待办后立即 put 加 flush,做到“改一条存一条”。不要把 flush 攒到最后统一做,中间任何一次异常退出都会丢掉一批未落盘的变更。

await preferences.put(KEY, JSON.stringify(list));
await preferences.flush();

flush() 是异步的,返回 Promise。对可靠性要求高时,用 await 确认写入完成后再做后续操作;批量写入时也可以攒一批后统一 flush,但要权衡性能和丢数据的风险窗口。

二、文件名用常量,启动时取同一个实例

每次启动应用,都要用相同的 name 去调用 dataPreferences.getPreferences(),拿到同一个 Preferences 实例。如果文件名拼了时间戳或随机值,重启后读到的就是另一个空文件,看起来就像“数据丢了”,其实是读错了文件。

建议把文件名定义为常量,全局统一引用;键名也一样,用常量集中管理,避免手写字符串拼错。

三、不要依赖退出回调做保存

鸿蒙应用被系统回收时,onDestroy 等生命周期回调不保证一定执行。如果把 flush() 放在退出回调里,系统杀进程、内存不足、用户强行停止应用时都会丢数据。保存的时机应该是数据变化的那一刻,而不是应用退出的那一刻。

这三条合起来就是一条原则:本地持久化要“及时、确定、可验证”。及时是指改完马上存;确定是指文件名和键名固定不变;可验证是指重启应用、杀进程后重新打开,清单内容仍然完整。把这三点做扎实,待办清单的本地体验才算真正可靠,再叠加云同步,才是完整的端云一体。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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