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,196 @@
+# uni.setStorageSync - 同步设置存储数据示例
+
+## 官方文档
+
+参考官方文档：https://doc.dcloud.net.cn/uni-app-x/api/storage/storage.html#setstoragesync
+
+## 概述
+
+`uni.setStorageSync` 用于同步将数据存储在本地缓存中指定的 key 中。
+
+## 基础用法
+
+```javascript
+try {
+  uni.setStorageSync('key', 'value')
+  console.log('存储成功')
+} catch (err) {
+  console.error('存储失败', err)
+}
+```
+
+## 完整示例
+
+### 示例 1: 存储用户信息
+
+```javascript
+try {
+  const userInfo = {
+    name: 'John',
+    age: 30,
+    email: 'john@example.com'
+  }
+  uni.setStorageSync('userInfo', userInfo)
+  console.log('存储成功')
+} catch (err) {
+  console.error('存储失败', err)
+}
+```
+
+### 示例 2: 存储 Token
+
+```javascript
+function saveToken(token) {
+  try {
+    uni.setStorageSync('token', token)
+    return true
+  } catch (err) {
+    console.error('存储Token失败', err)
+    return false
+  }
+}
+
+// 使用
+if (saveToken('abc123')) {
+  console.log('Token已保存')
+}
+```
+
+### 示例 3: 在页面中使用
+
+```vue
+<template>
+  <view class="container">
+    <input v-model="username" placeholder="用户名" />
+    <input v-model="email" placeholder="邮箱" />
+    <button @click="saveUserInfo">保存用户信息</button>
+  </view>
+</template>
+
+<script>
+export default {
+  data() {
+    return {
+      username: '',
+      email: ''
+    }
+  },
+  methods: {
+    saveUserInfo() {
+      try {
+        const userInfo = {
+          username: this.username,
+          email: this.email
+        }
+        uni.setStorageSync('userInfo', userInfo)
+        uni.showToast({
+          title: '保存成功',
+          icon: 'success'
+        })
+      } catch (err) {
+        uni.showToast({
+          title: '保存失败',
+          icon: 'none'
+        })
+      }
+    }
+  }
+}
+</script>
+```
+
+### 示例 4: 封装存储函数
+
+```javascript
+// utils/storage.js
+const storage = {
+  set(key, value) {
+    try {
+      uni.setStorageSync(key, value)
+      return true
+    } catch (err) {
+      console.error(`存储${key}失败`, err)
+      return false
+    }
+  },
+  
+  setString(key, value) {
+    return this.set(key, String(value))
+  },
+  
+  setNumber(key, value) {
+    return this.set(key, Number(value))
+  },
+  
+  setBoolean(key, value) {
+    return this.set(key, Boolean(value))
+  },
+  
+  setObject(key, value) {
+    return this.set(key, value)
+  }
+}
+
+// 使用
+storage.setString('token', 'abc123')
+storage.setNumber('count', 10)
+storage.setBoolean('isLogin', true)
+storage.setObject('userInfo', { name: 'John' })
+```
+
+### 示例 5: 批量存储
+
+```javascript
+function saveMultipleData(data) {
+  try {
+    Object.keys(data).forEach(key => {
+      uni.setStorageSync(key, data[key])
+    })
+    return true
+  } catch (err) {
+    console.error('批量存储失败', err)
+    return false
+  }
+}
+
+// 使用
+saveMultipleData({
+  token: 'abc123',
+  userInfo: { name: 'John' },
+  settings: { theme: 'dark' }
+})
+```
+
+## 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| key | String | 是 | 本地缓存中指定的 key |
+| data | Any | 是 | 需要存储的内容 |
+
+## 平台兼容性
+
+| 平台 | 支持情况 |
+|------|---------|
+| H5 | ✅ |
+| 微信小程序 | ✅ |
+| 支付宝小程序 | ✅ |
+| 百度小程序 | ✅ |
+| 字节跳动小程序 | ✅ |
+| QQ 小程序 | ✅ |
+| 快手小程序 | ✅ |
+| App | ✅ |
+| 快应用 | ✅ |
+
+## 注意事项
+
+1. 同步接口会阻塞后续代码执行，性能比异步接口好
+2. 存储的数据类型与设置时一致
+3. 建议使用 try-catch 处理错误
+4. 单个 key 允许存储的最大数据长度为 1MB
+
+## 参考资源
+
+- **官方文档**: https://doc.dcloud.net.cn/uni-app-x/api/storage/storage.html#setstoragesync
+- **异步版本**: 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#getstoragesync