localStorage键名需通过统一前缀、封装NamespacedStorage类、单键对象聚合及运行时校验四步隔离：前缀应含组织/产品名+模块名+版本号；工具类自动拼接键名并内置JSON序列化与容错；关联状态合并存储；读取时验证JSON格式与命名空间字段，捕获配额错误并降级。
localStorage 键名是全局唯一的，同一域名下所有脚本共享同一个存储空间。不加约束地使用简单键名（如 theme、token、user）极易被其他模块、第三方 SDK 或并行部署的前端项目覆盖，导致状态错乱或安全误判。核心解法不是等待浏览器支持命名空间，而是主动设计隔离机制。
统一前缀：最简且高性价比的隔离方式
为所有键名添加语义清晰、具备唯一性的前缀，是最直接有效的手段。前缀应体现项目、版本与业务域，避免缩写歧义：
- ✅ 推荐：const PREFIX = "acme_dashboard_v2_"; localStorage.setItem(`${PREFIX}sidebarCollapsed`, "true");
- ❌ 避免：localStorage.setItem("sidebar", "collapsed");（无归属、无版本、易撞）
- 前缀建议包含组织/产品名 + 模块/功能名 + 可选版本号，例如：shop_cart_v3_items、admin_logs_filter
封装 NamespacedStorage 类：提升可维护性与一致性
将前缀逻辑收口到工具类中，屏蔽原始 API 的裸用风险，同时集成 JSON 序列化、异常捕获等能力：
- 实例化时传入命名空间：const cartStore = new NamespacedStorage("cart_v3");
- 自动拼接键名：cartStore.set("items", [{id: 1}]); // 实际存为 "cart_v3_items"
- 内置容错：写入前校验是否为合法 JSON；读取失败时返回默认值或抛出结构异常
- 支持批量清理：cartStore.clear() 仅移除本命名空间下的所有键，不影响其他模块
单键对象聚合：减少键数量，规避并发写冲突
对强关联、低频更新的一组状态，优先合并为一个对象存储，而非拆成多个键：
- ✅ 推荐：localStorage.setItem("user_state", JSON.stringify({theme: "dark", lang: "zh-CN", notifications: true}));
- ❌ 拆分风险："user_theme"、"user_lang"、"user_notifications" —— 多次 set 可能因执行顺序或中间报错导致状态不一致
- 适用场景：用户偏好、表单草稿、UI 展开状态等小型状态集；不适用于独立高频变更字段（如实时计数器）
运行时校验与降级策略：增强生产环境鲁棒性
即使做了前缀隔离，仍需应对未知第三方脚本、手动调试污染或存储配额超限等现实问题：
- 读取时验证格式：检查值是否为预期 JSON，是否含 __ns 校验字段（如 {"__ns": "acme_dashboard_v2_", "theme": "dark"}）
- 捕获 QuotaExceededError：提示用户清理缓存，或临时 fallback 到 sessionStorage
- 键存在性检查：写入前用 Object.keys(localStorage).includes(key) 判断是否已被占用，必要时记录 warn 日志
