选 IndexedDB 还是 LocalStorage，关键看你要存什么、存多少、要不要查、是否需要事务支持。简单键值对、小数据（

选 IndexedDB 还是 LocalStorage，关键看你要存什么、存多少、要不要查、是否需要事务支持。简单键值对、小数据（

LocalStorage 适合这些场景

它本质是字符串键值对存储，所有值都会被自动转成字符串（比如 localStorage.setItem('count', 42) 存进去其实是 "42"）。操作同步、API 极简，但容量小（通常 5–10MB）、无索引、不支持二进制、无法遍历条件筛选。

• 保存用户偏好：主题色、语言、折叠状态等小量配置项
• 缓存简单页面状态：表单草稿、分页页码、最近搜索关键词
• 临时标记：登录态标识（注意：敏感 token 不建议单独依赖它）
• 调试辅助：快速存取调试开关或 mock 数据

IndexedDB 是为复杂数据设计的

它是浏览器内置的 NoSQL 数据库，支持对象存储、多对象仓库、索引、游标遍历、事务和异步操作。能存 JS 对象、文件、Blob，容量可达数百 MB（具体取决于浏览器和磁盘空间），且支持按字段查询（比如“查所有 status 为 'pending' 的订单”）。

• 离线应用核心存储：待同步的聊天消息、笔记草稿、订单缓存
• 大文件元数据管理：本地上传队列、图片缩略图信息、音频播放历史
• 需关系或范围查询的数据：日历事件（按日期范围查）、联系人（按姓名模糊匹配）
• 需要版本迁移的数据结构：比如 v1 存 {name, email}，v2 增加 {phone, avatar}

别踩这些常见坑

LocalStorage 容易误用：存对象不序列化会变 [object Object]；频繁 setItem 触发同步阻塞主线程；跨域 iframe 无法共享；Safari 无痕模式下可能直接抛错。IndexedDB 则常因忽略版本升级逻辑导致 open 失败，或忘记在事务完成前访问 store 而报 “InvalidStateError”。

• LocalStorage 写入前务必 JSON.stringify()，读取后 JSON.parse()
• IndexedDB 打开数据库时 version 变了，必须监听 onupgradeneeded 并手动创建/修改 objectStore
• 所有读写操作必须在事务内进行，事务生命周期内才能获取 objectStore 实例
• 不要用 IndexedDB 存敏感凭证——它和 LocalStorage 一样，同源脚本可直接读取

折中方案也值得考虑

不是非此即彼。常见组合方式有：用 LocalStorage 存轻量开关或令牌，用 IndexedDB 存主体业务数据；或者用 idb 库 封装 IndexedDB，大幅降低使用门槛；对中小项目，也可先用 LocalStorage + 简单 JSON 结构起步，等数据复杂度上升再平滑迁移到 IndexedDB（比如导出旧数据重建新库）。