鸿蒙实践笔记:ArkTS 本地数据持久化三件套选型与实战

举报
yd_236998400 发表于 2026/11/15 02:44:48 2026/11/15
【摘要】 一、从一次“闪退丢数据”说起做鸿蒙应用开发时,几乎每个开发者都会遇到这样一个场景:用户刚在待办清单里记下明天要交的材料,切换到别的 App 回来,数据不见了。原因并不复杂——数据只存在内存里的 @State 变量中,进程一回收就没了。把数据落到本地磁盘,是每个鸿蒙 App 从“演示”走向“可用”的第一道坎。ArkTS 官方给出的本地持久化方案主要有三件套:Preferences(轻量键值对...

一、从一次“闪退丢数据”说起

做鸿蒙应用开发时,几乎每个开发者都会遇到这样一个场景:用户刚在待办清单里记下明天要交的材料,切换到别的 App 回来,数据不见了。原因并不复杂——数据只存在内存里的 @State 变量中,进程一回收就没了。把数据落到本地磁盘,是每个鸿蒙 App 从“演示”走向“可用”的第一道坎。

ArkTS 官方给出的本地持久化方案主要有三件套:Preferences(轻量键值对)、关系型数据库(RDB)和文件存储。它们各有各的适用面,选错了,要么性能拉胯,要么代码越写越绕。

二、三件套速览

Preferences:系统提供的轻量级键值存储,适合存登录态、主题、开关这类“小而散”的配置。读写都是异步接口,用起来几乎没有学习成本。

关系型数据库:基于 SQLite 的结构化存储,适合存任务列表、订单、聊天记录这类“多而有关系”的数据,支持条件查询、排序和事务。

文件存储:直接读写沙箱内的文件,适合存图片、音频、导出的 JSON 这类“大块非结构化”内容。

一句话记住:配置用 Preferences,列表用数据库,大文件走文件。

三、Preferences:小数据的首选

登录成功后,token 和用户名要随应用“活着”,最简单的办法就是 Preferences:

import preferences from '@ohos.data.preferences';

const store = await preferences.getPreferences(this.context, 'user');
await store.put('token', token);
await store.flush();

注意两点:第一,put 只是写进内存缓存,必须调 flush() 才会真正落盘;第二,Preferences 不适合存大对象,官方建议单条数据控制在较小体积,存整个任务列表进去既慢又容易出问题。

四、关系型数据库:结构化数据的正解

当数据量上来、需要按条件查的时候,就该请出关系型数据库:

import relationalStore from '@ohos.data.relationalStore';

const config: relationalStore.StoreConfig = {
  name: 'todo.db',
  securityLevel: relationalStore.SecurityLevel.S1
};
const store = await relationalStore.getRdbStore(this.context, config);

建表、增删改查都走标准 SQL 语义,配合谓词(Predicates)可以按优先级、截止日期过滤。需要提醒的是,数据库操作是耗时操作,务必放在异步任务里做,别在 UI 线程上直接读写;批量写入时用事务包裹,一次提交比逐条提交快一个数量级。

五、文件存储:大块内容的归宿

图片、导出的备份文件这类内容,放数据库里是“反模式”,正确做法是写文件、数据库里只存路径:

import fs from '@ohos.file.fs';

const path = this.context.filesDir + '/backup.json';
const file = fs.openSync(path, fs.OpenMode.WRITE_ONLY | fs.OpenMode.CREATE);
fs.writeSync(file.fd, JSON.stringify(tasks));
fs.closeSync(file);

文件读写要区分应用沙箱目录:filesDir 是应用私有目录,随应用卸载而清除;需要用户可见的文件则走公共目录并申请相应权限。

六、选型对照表

方案 适合存什么 优势 注意事项
Preferences 登录态、开关、主题 简单、快速 别存大对象,记得 flush
关系型数据库 任务、订单、记录 可查询、可事务 异步操作、批量用事务
文件存储 图片、音频、备份 容量大、格式自由 只存路径进数据库

七、实战组合:一个待办清单的数据分层

拿“云同步待办清单”这个案例来说,落地时可以这样分层:登录 token 和上次同步时间放 Preferences;任务本身(标题、优先级、截止日期、完成状态)放关系型数据库;导出的备份文件走文件存储。三层各司其职,端侧代码反而更干净:UI 层只关心状态,数据层按类型分流,云同步时只需要把数据库里的增量变更推上去。

反过来,如果所有数据都塞进 Preferences,列表一长就会卡顿;如果把 token 存进数据库,每次启动都要多一次查询,纯属多余。分层不是为了“显得专业”,而是让每种数据的读写成本都落在最低点。

八、避坑清单

  1. 不要在 UI 线程做数据库读写,耗时操作一律异步。
  2. Preferences 写完记得 flush,否则杀进程就丢。
  3. 数据库升级要写迁移逻辑,onUpgrade 里补字段,别直接删库重建。
  4. 敏感信息不要明文存,token 至少要做加密或走系统密钥服务。
  5. 离线优先:先读本地缓存再联网同步,弱网环境下体验差距非常明显。

九、小结

本地持久化没有“银弹”,只有“合适的选择”。小配置用 Preferences,结构化数据用关系型数据库,大文件走文件存储,再配合云端同步做多端备份,一台手机上的鸿蒙应用就有了完整的数据底座。下一篇文章,我会继续写端云同步里的增量拉取怎么做,欢迎关注交流。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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