$patch批量更新state可避免重复响应:对象式适合同层字段更新并支持TS类型检查;函数式适用于依赖当前值的逻辑操作;复杂表单应聚合更新;配合$subscribe统一处理副作用。

用 $patch 批量更新多个 state,核心是把多次赋值压缩成一次响应式操作,避免重复触发计算属性、watch 和组件重渲染。
对象式 $patch:适合字段明确、同层更新
当你清楚要改哪些字段,且它们都在 state 根层级时,直接传一个对象最简洁:
store.$patch({ name: '小王', age: 25, role: 'admin' })- 内部自动做浅合并,只更新传入字段,其余保持不变
- TypeScript 下有类型提示,拼错字段名会报错,安全性高
- 不支持嵌套路径写法(如
{ 'user.email': 'x@y.com' }无效)
函数式 $patch:适合依赖当前值或带逻辑的更新
需要读取现有状态做判断、增删数组、递增计数等场景,用函数更安全:
store.$patch(state => { state.count++; if (state.items.length > 5) state.items.shift(); })- 操作的是响应式代理,不能解构
state,也不能给state重新赋值 - 适合数组 push/pop、条件覆盖、累加统计等动态逻辑
- 对 Map、Set 或 Class 实例,建议配合显式赋值使用,避免响应丢失
复杂表单场景:聚合更新时机,别频繁 patch
多个输入框同步到 store 时,不要每次 input 就调一次 $patch:
- 用
storeToRefs提取需监听的字段(如name、email),缩小响应范围 - 在提交、失焦或防抖后,再统一执行
store.$patch({ name, email, phone }) - 频繁小更新反而增加开销,聚合后一次提交更高效
配合 $subscribe 控制副作用触发
更新后要发请求、存 localStorage 或打日志,别在每个赋值后写逻辑:
- 用
store.$subscribe监听最终 patch 完成事件 store.$subscribe((mutation) => { if (mutation.type === 'patch object') saveToLocalStorage(store.$state) })- 加
{ detached: true }可全局监听,避免组件卸载时重复注册 - 确保副作用只执行一次,而不是被拆散的多次更新反复触发


















