localStorage的持久化是有限边界的长期保存，受用户操作、浏览器策略、存储配额及系统环境共同影响，需通过异常捕获、空值校验、时间戳标记、手动备份和降级策略保障稳定性。
localStorage 的“持久化”不是绝对的，而是一种有边界的长期保存——它能扛住页面刷新、浏览器重启甚至电脑关机，但随时可能被用户一键清空，或因隐私模式、存储超限、系统清理而失效。真正关键的不是“能不能存久”，而是“如何在可控范围内用得稳”。
持久化的实际边界在哪里
localStorage 的数据生命周期由浏览器和用户共同决定：
- 同域名下默认长期保留，无自动过期机制
- 用户手动清除浏览数据（如 Chrome 的「清除缓存」）时，localStorage 会一并被删除
- 无痕/隐私窗口关闭即清空，不跨会话留存
- 多数浏览器配额为 5–10 MB，超出后 setItem 会抛出 QuotaExceededError，写入静默失败
- iOS Safari 在内存紧张时可能主动丢弃部分 localStorage 数据，不触发任何提示
清除操作的常见触发场景
清除并非只来自用户点击「清除数据」，开发中需预判这些隐性清除路径：
- 代码调用：执行 removeItem(key) 或 clear() 会立即释放对应数据
- 跨域隔离：同一网站若混用 http/https、www/non-www 或不同端口，数据互不可见，相当于逻辑上“被清空”
- 浏览器策略变更：如 Safari 的 ITP（智能跟踪预防）可能限制第三方上下文中的 localStorage 写入能力
- 应用升级或重装：PWA 或 WebView 场景下，某些平台会重置存储空间
权衡策略：让“持久”更可靠
不追求绝对不变，而是通过设计降低单点失效风险：
- 写入必加 try-catch：捕获 QuotaExceededError 和 DOMException，避免静默失败
- 读取先判空再解析：getItem 返回 null 时直接 JSON.parse 会报错，应提供默认值或跳过处理
-
关键数据加时间戳标记：例如保存
{ data: ..., savedAt: Date.now() }，业务层可按需判定是否过期 - 提供手动导出入口：让用户点击「备份为 JSON 文件」，把核心配置或草稿掌握在自己手中
- 降级 fallback：localStorage 不可用时，退回到 sessionStorage 或内存缓存，保障基础功能不中断
什么时候该主动清除
清除不是缺陷，而是必要维护手段：
- 用户退出登录时，删掉 token、用户信息等敏感字段，避免残留
- 表单提交成功后，及时 removeItem 对应草稿键，防止旧数据干扰下次填写
- 检测到数据结构变更（如后端 API 升级），清空旧格式缓存，避免解析异常
- App 版本更新后，根据 version 标记批量清理过期 key，保持存储整洁
