企业级前端本地存储需建立四类规范体系：命名与分类（四段式小写下划线）、敏感数据加密（轻量加密+动态密钥+HttpOnly优先）、容量监控（配额预警+IndexedDB统计+大值扫描）、废弃清理（TTL元数据+自动过期剔除+版本迁移保留）。
企业级前端本地数据存储不能靠经验或临时方案凑合，必须形成可审计、可维护、可降级的规范体系。核心不是“存得下”，而是“存得稳、读得准、看得清、退得净”。以下四类关键规范，覆盖从写入到销毁的全生命周期。
命名与分类规范：让每个键名自带业务语义
避免使用 user、data1、temp 这类模糊键名。应采用 域_子域_用途_版本 四段式结构：
-
域：项目或产品缩写（如
crm、pay） -
子域：模块或功能（如
profile、cart） -
用途：明确操作意图（如
pref表偏好、draft表草稿、token表凭证） -
版本：格式为
v2，便于后续升级时自动迁移或废弃
示例：pay_cart_draft_v3、crm_profile_pref_v1。所有键名统一小写+下划线，禁止大小写混用或驼峰。
敏感数据加密规范：不依赖浏览器默认安全边界
localStorage/sessionStorage 本质无访问隔离，任何含用户身份、支付信息、会话凭证的数据都不得明文存储：
前端设计优化skill
下载
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
立即学习“前端免费学习笔记（深入）”；
- 仅对确需前端解密使用的字段做轻量加密（如 AES-GCM 或 Web Crypto API 的
SubtleCrypto.encrypt），密钥不硬编码，由运行时动态派生（例如基于用户登录态生成派生密钥） - Token 类凭证优先走
HttpOnly Cookie；若必须存前端，只存短时效（≤15 分钟）且绑定设备指纹的 JWT，并配合内存缓存 + 定时清除 - 禁止在 localStorage 中存储原始密码、身份证号、银行卡号；如业务强需，必须经服务端脱敏后返回再缓存，且标注
_masked后缀（如user_id_masked_v1）
容量与健康监控规范：把存储当服务来运维
前端本地存储不是“无限硬盘”，需主动观测与预警：
- 启动时/每日首次活跃时，调用
navigator.storage.estimate()获取当前配额使用率，超过 70% 触发日志上报（含页面 URL、存储类型、已用/总容量） - 对 IndexedDB 每个 objectStore 建立独立统计：记录条目数、平均对象大小、最近写入时间，异常增长（如单日新增 >5000 条）自动触发告警
- Web Storage 使用
Object.keys(localStorage).map(k => [k, localStorage.getItem(k)?.length || 0])扫描大值项（>50KB），标记并通知研发团队评估必要性
废弃与清理规范：杜绝“缓存僵尸”堆积
过期数据不清理 = 安全风险 + 性能拖累 + 调试噪音：
- 所有存储项必须声明
ttl（Time-To-Live）或expiresAt时间戳，写入时一并存入元数据（如{ value: '...', expiresAt: 1748052000000 }） - 建立统一清理策略：每次页面加载时扫描 Web Storage，自动剔除过期项；IndexedDB 则按
updatedAt字段 + 索引，在后台事务中分批删除（避免阻塞主线程） - 版本升级时，旧版键名（如
pay_cart_draft_v2）不立即删除，改为重命名为__deprecated_pay_cart_draft_v2_202605，保留 30 天后由定时任务彻底清除
