HarmonyOS7 preferences 存草稿刚刚好：轻量数据要有保存和清理边界

TimerHero

359人浏览 · 2026-07-25 09:40:02

TimerHero · 2026-07-25 09:40:02 发布

手绘笔记风信息图，主题是 HarmonyOS7 的 preferences 存草稿。画面中心是一张手

文章目录

前言

草稿数据通常不大，但对用户很重要。写到一半退出页面、应用被回收、网络提交失败，用户都希望内容还能找回来。HarmonyOS7 里 preferences 很适合保存这种轻量键值数据。

但它不是数据库，也不是万能缓存。我的习惯是提前想清楚三件事：恢复什么、什么时候保存、什么时候清理。草稿存储要及时，但不能无边界。

为什么这个问题经常被写乱

preferences 存草稿刚刚好这类内容很容易被写成“代码能跑就算讲完了”，但对初学者来说，这恰恰是最不够的地方。真正让人卡住的，往往不是某个组件名记不住，而是不知道这段代码为什么要这样拆、状态为什么要这样放、以后需求变化时应该从哪里改。

所以这篇文章不只想给你一个能跑的例子，更想把背后的判断过程讲清楚。你只要把这个判断过程吃透，后面自己改页面、补需求、查问题时，心里会稳很多。

什么适合放进 preferences

笔记草稿是典型场景：标题和正文都是字符串，数据量小，恢复价值高。

手绘蓝图风框架图，主题是 HarmonyOS7 草稿存储的判断框架。用三层结构展示：页面目标 ->

数据	是否适合	说明
草稿标题	适合	小而明确
草稿正文	适合短文本	长文或富文本要另选方案
图片列表	不适合	结构和体积都偏重
上次选择	适合	比如排序方式、开关配置

我会把 preferences 当成轻量记事本，而不是缓存层。只要数据开始变大、变复杂，就应该重新考虑存储方案。

先把页面目标想清楚

在真正写代码之前，先别急着盯着 API。更有用的做法是先想清楚：这个页面到底想解决什么问题，用户最在意的反馈是什么，哪些状态必须一直保持一致。

当你先把这条主线想明白，再回头看组件和状态设计，很多选择都会顺理成章。对小白来说，这一步尤其重要，因为它能帮你从“照着抄”慢慢过渡到“看得懂、改得动”。

完整 ArkTS 示例

import { preferences } from '@kit.ArkData'

@Entry
@Component
struct DraftPreferencePage {
  @State title: string = ''
  @State content: string = ''
  @State status: string = '草稿未加载'
  private store: preferences.Preferences | undefined = undefined

  async aboutToAppear(): Promise<void> {
    this.store = await preferences.getPreferences(getContext(this), 'noteDraft')
    this.title = await this.store.get('title', '') as string
    this.content = await this.store.get('content', '') as string
    this.status = '已恢复本地草稿'
  }

  private async saveDraft(): Promise<void> {
    if (!this.store) {
      return
    }
    await this.store.put('title', this.title)
    await this.store.put('content', this.content)
    await this.store.flush()
    this.status = '草稿已保存'
  }

  private async clearDraft(): Promise<void> {
    if (!this.store) {
      return
    }
    await this.store.delete('title')
    await this.store.delete('content')
    await this.store.flush()
    this.title = ''
    this.content = ''
    this.status = '草稿已清空'
  }

  build() {
    Column({ space: 12 }) {
      Text('笔记草稿')
        .fontSize(22)
        .fontWeight(FontWeight.Bold)
        .width('100%')

      TextInput({ placeholder: '标题', text: this.title })
        .onChange((value: string) => {
          this.title = value
        })

      TextArea({ placeholder: '写点内容...', text: this.content })
        .height(180)
        .onChange((value: string) => {
          this.content = value
        })

      Text(this.status)
        .fontSize(12)
        .fontColor('#777777')
        .width('100%')

      Row({ space: 10 }) {
        Button('保存草稿')
          .layoutWeight(1)
          .onClick(() => {
            this.saveDraft()
          })
        Button('清空')
          .layoutWeight(1)
          .backgroundColor('#F0F2F5')
          .fontColor('#333333')
          .onClick(() => {
            this.clearDraft()
          })
      }
      .width('100%')
    }
    .padding(16)
  }
}