indexeddb 适合存储结构化 web 环境配置，应按功能域拆分对象仓库（如 appsettings、apiendpoints）、设明确主键、利用版本升级控制 schema 演进，并封装读写操作配合应用生命周期同步状态。
用 IndexedDB 存本地 Web 环境配置，核心是把配置当作结构化数据来管理，而不是塞进 localStorage 里硬编码。它适合存多字段、带类型、需查询或未来可能扩展的配置项，比如主题模式、语言偏好、API 地址开关、调试开关、离线策略等。
设计合理的配置数据结构
避免把所有配置拼成一个大对象存成单条记录。推荐按功能域或环境维度拆分：
- 用独立的对象仓库（Object Store）区分配置类型，例如 appSettings（通用设置）、apiEndpoints（接口地址组）、featureFlags（特性开关）
- 每条配置记录带明确主键，如
keyPath: "id"或直接用字符串名作 key（如"theme"、"debugMode"） - 支持布尔、数字、字符串、数组甚至嵌套对象 —— IndexedDB 原生序列化 JavaScript 值，无需手动 JSON.stringify
初始化与版本升级控制
配置结构很可能随迭代变化（比如新增“深色模式生效时间”字段），必须靠版本号驱动升级：
- 首次打开数据库时指定版本号（如
indexedDB.open("configDB", 1)） - 后续加字段或改逻辑，升版本（如 v2），在
onupgradeneeded中安全创建新 store 或添加索引 - 示例：v2 新增
featureFlags仓库，且为enabled字段建索引，方便快速查启用中的功能
读写配置的常用操作模式
配置通常读多写少，建议封装成可复用方法，避免每次手动开事务：
-
读取单个配置：用
objectStore.get(key)，例如store.get("theme") -
批量读取多个键：用
store.getAll(IDBKeyRange.bound("api_", "api_\uffff"))匹配前缀 -
条件查询（如查所有启用的开关）：先建索引
store.createIndex("by_enabled", "enabled")，再用index.getAll(true) -
更新配置：走 readwrite 事务，调
put({id: "language", value: "zh-CN"})，自动覆盖同 key 记录
配合应用生命周期做同步与兜底
配置不是孤立存在，要和页面状态联动：
- 页面加载时，从 IndexedDB 读取配置并应用（如切换 CSS 类、设置 axios 默认 baseURL）
- 用户修改设置后，立即写入 DB，并触发自定义事件（如
dispatchEvent(new CustomEvent("configChanged"))）通知其他模块响应 - 为防首次访问无配置，可在
onupgradeneeded或首次onsuccess时插入默认值，避免空状态异常 - 不依赖网络，即使离线也能加载上次保存的配置，真正实现环境配置“本地化”
