watch本身不负责持久化,需配合localStorage等实现自动同步表单:监听字段变化、防抖写入、JSON安全序列化、页面加载时恢复、支持手动清除及敏感字段控制。

watch 本身不负责数据持久化,它只是响应式系统中监听数据变化的工具。真正实现“自动同步表单到缓存”,需要将 watch 作为触发器,配合 localStorage(或 IndexedDB、Pinia 持久化插件等)完成写入动作。关键在于监听时机、防抖控制、序列化安全和恢复逻辑。
监听表单字段变化并写入 localStorage
对表单响应式数据(如 ref 或 reactive 对象)使用 watch,捕获变更后立即存入 localStorage。注意:避免直接监听整个大对象,优先按字段粒度监听,减少冗余存储和性能开销。
- 用 watch 监听单个 ref:watch(formValue, (newVal) => { localStorage.setItem('formCache', JSON.stringify(newVal)); }, { deep: true });
- 监听多个字段可合并为一个 watch:watch([fieldA, fieldB], ([newA, newB]) => { ... });
- 确保 newVal 可被 JSON 安全序列化——避免存函数、Symbol、undefined 或循环引用;建议用 structuredClone(现代环境)或白名单过滤做预处理
添加防抖防止高频写入
用户连续输入时,频繁触发 localStorage 写入不仅低效,还可能影响主线程性能(尤其在低端设备)。引入防抖是必要优化。
- 借助 lodash.debounce 或手写简易防抖函数,在 watch 回调外包裹延迟执行
- 示例:const saveDebounced = debounce(() => localStorage.setItem(...), 800); watch(formValue, () => saveDebounced());
- 离开页面前(beforeunload)强制触发一次保存,兜底保障最后修改不丢失
页面加载时自动恢复缓存数据
持久化的意义在于“下次打开还能看见”。需在组件初始化或路由进入时读取 localStorage,并合并/覆盖初始表单值。
- 推荐在 onMounted 中读取:onMounted(() => { const cached = localStorage.getItem('formCache'); if (cached) Object.assign(formValue, JSON.parse(cached)); });
- 注意类型还原问题:JSON.parse 会丢失 Date、Map、Set 等类型,简单表单字段(字符串、数字、布尔、数组、扁平对象)通常无碍
- 可加版本号字段(如 cacheVersion: '1.2')实现缓存迁移或失效策略
提供手动清除缓存的入口
用户可能想重填表单,或敏感信息不宜长期留存。不能只写不删。
- 暴露一个 clearCache 方法:const clearCache = () => { localStorage.removeItem('formCache'); formValue.value = { ...initialValue }; };
- 在表单顶部或底部加轻量提示(如“已缓存 · 点击清空”),提升体验透明度
- 敏感表单(如登录、支付)建议默认禁用自动缓存,或仅缓存非关键字段(如邮箱、昵称)

















