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 的过期搜索记录更容易被舍弃 —— 工具的价值，在于把“容量意识”变成可编程的业务逻辑。