redux-localstorage 是一个 Redux 状态持久化库，它作为 Store enhancer 将 Redux store 中的全部或部分 state 同步到本地存储。在 0.x 版本中，它只支持浏览器的 localStorage；而面向未来的 1.0 版本（npm 上已发布为redux-localstorage@rc）引入了灵活可插拔的存储后端，让 sessionStorage 和 React Native 的 AsyncStorage 也能无缝接入。本文将带你了解这次升级的背景、方案与上手要点。

为什么要支持更多存储后端 🤔

在 0.x 版本里，存储目标是写死的。打开 src/persistState.js 可以看到，读取和写入都直接调用localStorage.getItem(key)与localStorage.setItem(key, ...)：

• 初始化时：从 localStorage 取出历史数据，与initialState合并后交给createStore（见 src/util/mergeState.js）
• 每次订阅触发时：把切分出的 state 子集序列化后写回 localStorage

这种"绑定死 localStorage"的设计在 Web 单页应用中够用，但遇到以下场景就力不从心：

1.0 的演进思路：把"存到哪"变成可配置项

1.0 的核心演进是存储抽象化：不再由库内部直接访问某个存储介质，而是允许使用者传入不同的存储实现。README.md 中明确预告了这一方向——1.0 分支"包括对灵活存储后端的支持，包括但不限于 sessionStorage 和 react-native 的 AsyncStorage"。

这一设计与 0.x 已有的"可定制管线"一脉相承。在 src/persistState.js 中，persistState(paths, config)早就支持覆盖以下环节：

• config.key：存储键名（默认redux）
• config.slicer：决定哪些 state 参与持久化（默认切分逻辑在 src/createSlicer.js 和 src/getSubset.js）
• config.serialize/config.deserialize：序列化与反序列化策略（默认JSON.stringify/JSON.parse）
• config.merge：初始化时的状态合并策略（默认实现在 src/util/mergeState.js）

1.0 相当于在这条管线上再补上最关键的一环——存储介质本身，从而让同一套持久化逻辑运行在 Web、移动端乃至测试环境中。

升级上手：如何切换到 1.0

第一步：安装 rc 版本

npm install --save redux-localstorage@rc

第二步：保持原有调用方式

基础用法与 0.x 一致：在createStore时通过compose把persistState作为 enhancer 传入，不传paths即持久化整个 store，传入字符串或数组则只同步顶层字段：

import persistState from 'redux-localstorage' const store = createStore( reducer, compose(persistState('user', { key: 'my-app' })) )

第三步：选择存储后端

升级到 1.0 后，按平台选择后端即可：

• Web 会话级数据→ 使用 sessionStorage：登录表单进度、页面级 UI 状态等"关标签页就该消失"的数据，避免与 localStorage 中的长期数据互相干扰
• React Native 应用→ 使用 AsyncStorage：与 Web 版共享同一套 reducer 与持久化配置，降低跨端维护成本

实践建议与常见坑 💡

1. 合理拆分 key：不同用途的数据用不同config.key（如session-draft、user-prefs），避免互相覆盖，也方便按需清理。
2. 谨慎选择持久化范围：默认持久化整个 store 容易把不该存的数据（如高频变化的 UI 状态）写入磁盘。建议显式指定paths，或用自定义slicer（接口约定见 README.md）。
3. 注意异常兜底：0.x 源码中对读取与写入都包裹了try/catch并给出console.warn提示（src/persistState.js），切换异步后端（如 AsyncStorage）时要确认异常与 Promise 被妥善处理，避免静默失败。
4. 关注 Quota 限制：localStorage/sessionStorage 通常只有几 MB 配额，持久化大对象前先评估体积。
5. 关注测试覆盖：库的核心逻辑配有完整单元测试，例如 src/tests/ 目录下的 createSlicer-test.js、getSubset-test.js，以及 src/tests/util/ 中的工具函数测试，可作为验证自定义策略的参考。

写在最后

从"只认 localStorage"到"存储后端可插拔"，redux-localstorage 1.0 的演进方向非常清晰：一套持久化逻辑，跑遍 Web、移动端与测试环境。如果你正在为 React Native 或多会话场景寻找 Redux 状态持久化方案，不妨关注这个正在推进的 1.0 分支。更多 API 细节可参阅 README.md 与 package.json。