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.生命周期: LocalStorage 驻留内存,不是持久化存储!App 杀掉数据丢失;持久化请用 Preferences。
- 2.作用域:
- 一个实例跨页面传递:需要手动实例共享;
- 推荐:一个页面 / 模块尽量使用一个 LocalStorage,不要滥用大量实例。
- 3.@LocalStorageProp vs @LocalStorageLink
@LocalStorageProp("key"):单向,组件内禁止赋值;只能通过 ls.set () 修改@LocalStorageLink("key"):双向,组件内this.xxx = val可同步回 LocalStorage
四、常见陷阱汇总
- ❌误区:LocalStorage 数据持久化 ✅真相:内存存储,进程销毁清空
- ❌误区:基础类型无法观测变化 ✅真相:基础类型天然可观测;数组 / 对象内层修改才容易不触发刷新
- ❌误区:全局只能有一个 LocalStorage ✅真相:支持多个独立实例
- ❌误区:同一个 key 可以随意更换存储类型 ✅真相:首次赋值锁定类型
1
1
浏览133 发布于2026-07-22 08:01浙江
全部评论
最多点赞
最新发布
最早发布
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
目录 收起
一、基础定义
二、特性概要
1. 类型规则
2. 属性可变性
3. 变动观测
4. 多实例
三、高频易混点补充
四、常见陷阱汇总
了解社区公约,与您携手共创和谐专业的开发者社区。







































苏公安网备 32011402010933号