refactor: 架构升级

2026-09-13 00:50:40 +08:00 · 2026-08-31 07:58:23 +08:00
commit ba5b77568b
693 changed files with 118430 additions and 0 deletions
@@ -0,0 +1,160 @@
+# uni.setStorage - 数据存储示例
+
+## 官方文档
+
+参考官方文档：https://doc.dcloud.net.cn/uni-app-x/api/storage/storage.html#setstorage
+
+## 概述
+
+`uni.setStorage` 用于将数据存储在本地缓存中指定的 key 中，异步接口。
+
+## 基础用法
+
+```javascript
+uni.setStorage({
+  key: 'userInfo',
+  data: {
+    name: 'John',
+    age: 30
+  },
+  success: () => {
+    console.log('存储成功')
+  },
+  fail: (err) => {
+    console.error('存储失败', err)
+  }
+})
+```
+
+## 完整示例
+
+### 示例 1: 存储用户信息
+
+```javascript
+// 存储用户信息
+const userInfo = {
+  id: 1,
+  name: 'John Doe',
+  email: 'john@example.com',
+  avatar: 'https://example.com/avatar.jpg'
+}
+
+uni.setStorage({
+  key: 'userInfo',
+  data: userInfo,
+  success: () => {
+    uni.showToast({
+      title: '保存成功',
+      icon: 'success'
+    })
+  },
+  fail: (err) => {
+    uni.showToast({
+      title: '保存失败',
+      icon: 'none'
+    })
+  }
+})
+```
+
+### 示例 2: 存储字符串
+
+```javascript
+uni.setStorage({
+  key: 'token',
+  data: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
+  success: () => {
+    console.log('Token 已保存')
+  }
+})
+```
+
+### 示例 3: 存储数组
+
+```javascript
+const shoppingCart = [
+  { id: 1, name: '商品1', price: 99 },
+  { id: 2, name: '商品2', price: 199 }
+]
+
+uni.setStorage({
+  key: 'shoppingCart',
+  data: shoppingCart,
+  success: () => {
+    console.log('购物车已保存')
+  }
+})
+```
+
+### 示例 4: 封装存储函数
+
+```javascript
+// utils/storage.js
+const storage = {
+  set(key, data) {
+    return new Promise((resolve, reject) => {
+      uni.setStorage({
+        key: key,
+        data: data,
+        success: () => {
+          resolve()
+        },
+        fail: (err) => {
+          reject(err)
+        }
+      })
+    })
+  },
+  
+  get(key) {
+    return new Promise((resolve, reject) => {
+      uni.getStorage({
+        key: key,
+        success: (res) => {
+          resolve(res.data)
+        },
+        fail: (err) => {
+          reject(err)
+        }
+      })
+    })
+  }
+}
+
+// 使用
+storage.set('userInfo', { name: 'John' })
+  .then(() => {
+    console.log('存储成功')
+  })
+  .catch(err => {
+    console.error('存储失败', err)
+  })
+```
+
+## 同步版本
+
+使用 `uni.setStorageSync` 进行同步存储：
+
+```javascript
+try {
+  uni.setStorageSync('userInfo', {
+    name: 'John',
+    age: 30
+  })
+  console.log('存储成功')
+} catch (err) {
+  console.error('存储失败', err)
+}
+```
+
+## 注意事项
+
+1. 存储的数据会被持久化，除非手动删除或清除缓存
+2. 单个 key 允许存储的最大数据长度为 1MB
+3. 异步接口不会阻塞后续代码执行
+4. 建议使用 try-catch 处理同步接口的错误
+
+## 参考资源
+
+- **官方文档**: https://doc.dcloud.net.cn/uni-app-x/api/storage/storage.html#setstorage
+- **同步版本**: https://doc.dcloud.net.cn/uni-app-x/api/storage/storage.html#setstoragesync