小程序开发中，数据存储是构建交互体验的核心。与网页不同，小程序没有传统意义上的“本地数据库”，但它提供了一套简洁高效的客户端数据存储方案，让你轻松保存用户偏好、临时状态等关键信息。掌握它，你的小程序将更加“聪明”和人性化。

一、核心武器：wx.setStorageSync - 你的“记忆口袋”

想象一下，用户选择了深色模式，你肯定不希望他下次打开又变回默认亮屏。这时，就需要用到同步存储 API。它就像一个小程序的“记忆口袋”，可以把数据存在用户手机里，随时取用。

怎么存？

使用 `wx.setStorageSync`，一句话搞定：

wx.setStorageSync('key', 'value')

例如，存储用户主题设置：

wx.setStorageSync('theme', 'dark')

怎么取？

使用 `wx.getStorageSync`，同样简单：

const theme = wx.getStorageSync('theme') // 取出来就是 'dark'

同步 vs 异步： 带“Sync”的方法是同步的，代码会立刻执行并得到结果。小程序也提供了异步版本（如`wx.setStorage`），它不会阻塞后续代码，但写法上需要用回调函数。对于存储简单数据，同步方法更直观易懂。

二、实战场景：让小程序记住用户的选择

光看概念不够，我们来看一个真实例子：保存用户的登录用户名。

1. 用户登录后，立刻保存信息：

```javascript // 用户点击登录按钮后 onLoginSuccess(userInfo) { // 将用户名存储到本地，key为'username'，value为实际用户名 wx.setStorageSync('username', userInfo.name); // 可以同时存储更多信息，比如用户ID wx.setStorageSync('userId', userInfo.id); } ```

2. 下次启动，自动读取显示：

在小程序启动生命周期（如`onLaunch`）或页面加载时（`onLoad`），读取数据：

```javascript onLoad() { const savedName = wx.getStorageSync('username'); if (savedName) { // 如果存在用户名，则直接显示“欢迎回来，XXX” this.setData({ welcomeText: `欢迎回来，${savedName}` }); } } ```

这样，用户无需每次手动登录，体验大幅提升。

三、进阶技巧与注意事项

1. 存复杂数据： 不仅可以存字符串，数字、布尔值、对象、数组都可以。存储对象或数组时，系统会自动将其序列化。

wx.setStorageSync('user', { name: '小明', age: 18, tags: ['老用户', 'VIP'] })

2. 清除数据： - 清除某一项：`wx.removeStorageSync('key')` - 清空全部：`wx.clearStorageSync()` （谨慎使用！）

3. 重要限制： - 容量上限： 每个小程序的本地存储总容量约为 **10MB**。不要滥用它来存大量图片或视频。 - 数据类型： 存储的 key 只能是字符串，value 可以是任何可 JSON 序列化的类型。 - 用户清除： 数据存储在用户设备上，如果用户通过手机设置清理微信缓存，这些数据也会被清除。

四、扩展：哪种数据该存？哪种不该存？

- 强烈推荐存： 用户个性化设置（如主题、字体大小）、登录后的临时令牌（token）、表单草稿、浏览历史等非关键性且需要提升体验的数据。

- 千万不要只依赖本地存： 用户余额、订单详情、核心个人资料等重要数据。这些必须从服务器端实时获取，本地存储只能作为临时缓存，并做好数据失效的判断。

- 考虑使用全局变量： 对于仅在本次小程序运行期间需要的临时数据（如页面间传递的复杂参数），使用小程序的全局变量 `getApp().globalData` 可能更合适，它生命周期更短，不占用存储空间。

总结

小程序数据存储 (`wx.setStorageSync`) 就像给你的小程序配了一个“智能记事本”。它用法简单，但威力巨大，是优化用户体验的必备技能。记住核心原则：轻量存储、提升体验、关键数据回源服务器。现在，就去给你的小程序加上“记忆”功能吧！