【UniApp小程序知识点总结】uni-app 微信小程序本地持久化存储实现

目录

一、 认识 uni-app 的本地存储 API

1. 同步 API（带 Sync 后缀）

2. 异步 API（无 Sync 后缀）

二、 基础实战：同步 vs 异步怎么选？

同步写法（简单直接）

异步写法（回调 / Promise）

三、 核心机制：自动 JSON 序列化/反序列化

四、 避坑指南：必须知道的限制

1. 存储容量上限：10MB

2. 数据隔离性

3. 数据可能会被微信清理

五、 进阶封装：打造带过期时间的本地缓存

在页面中使用封装后的工具：

六、 总结

在开发 uni-app 微信小程序时，我们经常会遇到需要将数据保存在本地的场景：比如记住用户的登录状态、保存用户的个性化设置、缓存列表数据以优化加载速度等。

这时候，就需要用到小程序的本地存储能力。

一、 认识 uni-app 的本地存储 API

uni-app 将微信小程序的 wx.setStorage 和 wx.setStorageSync 等 API 进行了封装，提供了统一的调用方式。根据同步与异步的区别，主要分为两套 API：

1. 同步 API（带 Sync 后缀）

• uni.setStorageSync(key