localStorage实际可用容量非固定值，通常5MB左右但因浏览器、平台、编码等差异而波动；应通过TextEncoder计算UTF-8字节长度并预留10%余量，结合试探写入+异常捕获双保险机制，按前缀、过期、损坏分级精准清理，大数据需降级至IndexedDB。
localStorage 的实际可用容量因浏览器而异，通常在 5MB 左右，但并非固定值，且受同源策略、私有模式、存储键名长度、字符编码（如中文占更多字节）等影响。单纯依赖“理论值”容易导致 QuotaExceededError 异常。实现可靠的存储管理，关键不在于精确预测容量上限，而在于主动监控使用量 + 智能清理策略。
实时估算当前 localStorage 占用字节数
localStorage 的 length 和 key() 只反映条目数量，不体现体积。需手动计算所有键值对的 UTF-16 字节长度：
- JavaScript 字符串按 UTF-16 编码，每个字符通常占 2 字节；代理对（如部分 emoji）占 4 字节
- 键名和值都需计入：总字节数 = Σ( key.length × 2 + value.length × 2 )
- 更准确的做法是用
new TextEncoder().encode(str).length（兼容性较好）或unescape(encodeURIComponent(str)).length（兼容旧浏览器）
设定安全阈值并监听临界状态
不要等到写入失败才响应。建议预留 10%–20% 缓冲空间，例如以 4.5MB 为软上限：
- 每次写入前检查当前占用是否接近阈值，若超限则触发清理流程
- 可封装
safeSetItem(key, value)，内部自动校验 + 清理 + 再写入 - 配合
window.addEventListener('storage', ...)监听跨标签页变更（仅本域其他窗口触发），辅助同步状态
分级清理策略：优先保留关键数据
避免盲目清空。推荐按数据重要性和时效性分级：
-
永久型：用户显式保存的配置（如主题偏好、表单草稿）、登录凭证（应加密后存）、离线业务主数据 —— 标记
keep: 'forever' -
时效型：API 缓存、临时筛选状态、页面足迹 —— 带
expires: Date.now() + 24*60*60*1000字段，过期自动剔除 -
可弃型：日志快照、调试信息、冗余缩略图 Base64 —— 标记
priority: 'low'，清理时最先移除
提供开发者友好的调试与干预接口
便于排查和手动维护：
- 导出当前存储快照：
localStorageUtils.list({ includeSize: true })返回带字节大小的键值列表 - 一键清理低优先级项：
localStorageUtils.clearLowPriority() - 查看剩余空间估算：
localStorageUtils.getUsage()返回 { used: 4235678, limit: 5242880, ratio: 0.808 } - 支持 mock 模式，方便在测试环境模拟容量不足场景
不复杂但容易忽略的是：清理不能只看大小，更要理解数据语义。一个 2MB 的用户头像 Base64 字符串，可能比十个 1KB 的过期搜索记录更容易被舍弃 —— 工具的价值，在于把“容量意识”变成可编程的业务逻辑。
