文档开发者中心
我的
|

ArkUI

LocalStorage 特性速查

一、基础定义

LocalStorage:页面级内存状态容器,生命周期跟随创建它的 UIAbility / 页面;暂存于内存中,不会自动持久化,不能跨页面访问。

配套装饰器:@LocalStorageProp、@LocalStorageLink。

二、特性概要

1. 类型规则

LocalStorage.set (key, value)

首次 set 会锁定该 key 的数据类型; 后续再次 set 同一个 key,必须传入相同类型。

例:先存 number ls.set("count", 1),后续不能直接 ls.set("count", "1"),会异常。

2. 属性可变性

LocalStorage 内所有属性都是可变(mutable)。

  • @LocalStorageProp:单向同步,组件内只读,不能直接赋值修改;
  • @LocalStorageLink:双向同步,组件内可修改;

3. 变动观测

boolean /string/number 原始基础类型,完全可以被观察、驱动 UI 刷新。

对象、数组存在特殊场景:直接修改数组下标、对象内层属性,默认无法观测;需要替换引用(重新赋值)触发更新。

4. 多实例

应用支持创建多个互相独立的 LocalStorage 实例

收起
自动换行
深色代码主题
复制
let ls1 = new LocalStorage();
let ls2 = new LocalStorage();

ls1、ls2 存储空间隔离,key 互不干扰。

三、高频易混点补充

  1. 1.生命周期: LocalStorage 驻留内存,不是持久化存储!App 杀掉数据丢失;持久化请用 Preferences。
  2. 2.作用域:
  • 一个实例跨页面传递:需要手动实例共享;
  • 推荐:一个页面 / 模块尽量使用一个 LocalStorage,不要滥用大量实例。
  1. 3.@LocalStorageProp vs @LocalStorageLink
  • @LocalStorageProp("key"):单向,组件内禁止赋值;只能通过 ls.set () 修改
  • @LocalStorageLink("key"):双向,组件内 this.xxx = val 可同步回 LocalStorage

四、常见陷阱汇总

  1. ❌误区:LocalStorage 数据持久化 ✅真相:内存存储,进程销毁清空
  2. ❌误区:基础类型无法观测变化 ✅真相:基础类型天然可观测;数组 / 对象内层修改才容易不触发刷新
  3. ❌误区:全局只能有一个 LocalStorage ✅真相:支持多个独立实例
  4. ❌误区:同一个 key 可以随意更换存储类型 ✅真相:首次赋值锁定类型
点赞
收藏
1
回复
1
分享
举报
浏览133 发布于2026-07-22 08:01浙江
全部评论
最多点赞
最新发布
最早发布
不同角度学习
1楼回复于2026-07-23 09:29 来自北京
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

目录 收起
一、基础定义
二、特性概要
1. 类型规则
2. 属性可变性
3. 变动观测
4. 多实例
三、高频易混点补充
四、常见陷阱汇总
了解社区公约,与您携手共创和谐专业的开发者社区。