$patch 是 Pinia 推荐的批量更新 store 状态方式，支持对象式和函数式两种用法：对象式用于同层级字段的精准合并更新，函数式适用于基于当前 state 计算新值的场景，兼具性能、安全与类型友好性。
Pinia 的 $patch 是批量更新 store 状态的高效方式，它比逐个赋值更轻量、比直接替换整个 state 更精准，尤其适合需要同时修改多个字段又不想触发多余响应式开销的场景。
什么时候该用 $patch？
当你需要一次性修改 store 中的多个响应式属性，且这些属性属于同一层级（比如都是根级字段），又不希望写一堆 state.xxx = ... 语句时，$patch 就是最佳选择。它内部会合并变更、只触发一次依赖更新，避免重复渲染。
- 修改用户资料：昵称、头像、个性签名一起更新
- 表单暂存：多个输入框内容同步写入 store
- 配置切换：主题色、语言、通知开关批量设置
两种用法：对象式和函数式
对象式最常用，直接传入一个部分 state 对象：
store.$patch({
name: '张三',
age: 28,
isActive: true
})
函数式适合需要基于当前 state 计算新值的场景（比如递增计数器、条件覆盖）：
store.$patch((state) => {
state.count++
if (state.items.length > 10) {
state.items = state.items.slice(-10)
}
})
注意：函数式写法中，你操作的是 state 的响应式代理，无需 return，但不能解构或重新赋值 state 变量本身。
和直接赋值、$state 替换的区别
对比逐个赋值：store.name = '李四'; store.age = 30; —— 每次赋值都可能触发一次响应式更新，性能略低，代码也冗长。
对比 $state 全量替换：store.$state = { ...store.$state, name: '王五', age: 32 }; —— 会丢失响应式连接（尤其在使用 ref 或嵌套对象时易出问题），且强制重置整个 state，不够安全。
$patch 则保留响应式引用、只更新指定字段、内部做最小化依赖通知，是官方推荐的批量更新方式。
注意事项和常见坑
• 不支持深层嵌套路径的快捷更新（比如 $patch({ 'profile.email': 'a@b.com' }) 无效），需用函数式或手动进入子对象。
• 在 Vue 组件中调用时，确保 store 已正确实例化，避免 undefined.$patch 报错。
• 如果状态结构复杂（如含 Class 实例、Map/Set），$patch 可能无法深度响应，此时建议用函数式 + 明确赋值。
• TypeScript 下，对象式 $patch 会自动类型推导，字段名写错会有提示，很友好。
