Index 是 objectStore 的辅助查询结构，类似二级索引，支持按非主键字段快速查找；objectStore 以主键唯一标识数据，而 index 按指定字段值建立索引，允许多个且可嵌套路径，但要求字段存在且为基本类型。
IndexedDB 中 index 是什么，和 objectStore 有什么区别
index 不是独立数据库，而是 objectStore 的辅助查询结构，类似数据库里的“二级索引”——它让你能按非主键字段快速查找数据。主键（keyPath）只能有一个，但你可以为 name、status、createdAt 等任意字段建多个 index，前提是这些字段在存入时确实存在且可提取。
关键区别：objectStore.get(key) 只能按主键查；而 index.get(value) 或 index.openCursor(IDBKeyRange.bound(...)) 才能按你定义的字段查。
常见错误：建了 index 却没在 add() / put() 时提供对应字段值，导致该条记录不被索引覆盖——查不到不是语法错，是数据缺失。
怎么创建带 index 的 objectStore（升级 DB 版本是必须的）
IndexedDB 不允许运行时新增 index，必须在 onupgradeneeded 中声明。哪怕只加一个 index，也得把 DB 版本号 +1，否则回调根本不会触发。
立即学习“前端免费学习笔记（深入）”；
const request = indexedDB.open('mydb', 2); // 从 v1 升到 v2
request.onupgradeneeded = (event) => {
const db = event.target.result;
const store = db.createObjectStore('users', { keyPath: 'id' });
// ✅ 正确：指定字段名，且 unique 控制是否允许重复值
store.createIndex('byEmail', 'email', { unique: true });
store.createIndex('byStatus', 'status', { unique: false });
};
注意：createIndex() 第二个参数是字段路径字符串，支持嵌套如 'profile.age'，但要求数据中该路径真实存在且非 undefined。
容易踩的坑：
- 版本没变 →
onupgradeneeded不执行 → index 没建 → 后续所有index.get()报NotFoundError - 字段名拼错（比如写成
'emial'）→ index 建了但永远查不到数据 - 设了
{ unique: true }，但插入两条相同email→add()抛ConstraintError
用 index 查询数据的三种典型写法
查单条、查范围、查全部，都走 index 对象，不是 objectStore。
假设已打开事务、拿到 store 和 index = store.index('byEmail')：
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
✅ 查单条（精确匹配）：index.get('alice@example.com') → 返回第一个匹配项
✅ 查多条（范围匹配）：index.openCursor(IDBKeyRange.bound('a', 'z')) → 查 email 以 a–z 开头的全部
✅ 查全部（不带条件）：index.openCursor() → 遍历该 index 下所有记录（注意：顺序按索引字段值升序）
性能提示：用 IDBKeyRange.only(value) 比 bound(value, value) 更明确，引擎可能优化；大量数据时避免 index.getAll()，改用游标分页。
为什么 index.get() 有时返回 undefined，但数据明明存在
最常见原因不是代码错，而是数据写入时该字段为 undefined、null 或根本不存在——IndexedDB 的 index 默认跳过这些值，不建立索引条目。
验证方法：用 objectStore.getAll() 拿出原始数据，检查目标字段是否真有值。
补救方式只有两个：
- 删库重来（开发期可用：
indexedDB.deleteDatabase('mydb')） - 遍历所有数据，用
put()补全缺失字段再保存（生产环境慎用）
另一个隐蔽点：index 字段值如果是对象或数组，IndexedDB 会静默忽略——它只接受基本类型（string/number/date/boolean）或可序列化的简单结构。别试图用 createIndex('byTags', 'tags') 查数组内容，得用多条 flat 数据或额外设计 schema。
