Pinia 的 actions 是修改 state 的推荐入口,适合一次更新多个字段;应使用 $patch(对象式或函数式)统一提交以避免多次响应式通知;高频场景需配合 storeToRefs 聚合更新;重置状态优先用 $reset 或手动赋值 $state。

在 Action 内部集中修改多个 State 属性
Pinia 的 actions 是修改 state 的推荐入口,尤其适合一次更新多个字段。它不是简单地“调用函数”,而是把业务逻辑、数据校验、副作用(如 API 请求)和状态变更统一收口,避免组件中散落赋值。
用 $patch 一次性合并多个字段更新
直接在 action 中多次赋值(如 this.name = 'A'; this.age = 28; this.active = true)会触发多次响应式通知,造成不必要的重渲染和性能开销。正确做法是使用 this.$patch 统一提交:
-
对象式 $patch:适用于字段明确、无需读取当前值的场景
this.$patch({ name: 'A', age: 28, isActive: true }) -
函数式 $patch:适用于需基于当前值计算、操作数组或做条件判断的情况
this.$patch(state => { state.count++; state.items.push(newItem); })
无论改几个属性,都只触发 1 次响应式更新、1 次依赖通知、1 次 DevTools 日志记录。
配合 storeToRefs + 聚合时机,避免频繁小更新
在表单等高频输入场景,不要为每个 input change 都调用 action 或 $patch。应:
- 用
storeToRefs提取需要双向绑定的字段(如name、email),保持响应式但不监听整个 store - 将多个字段收集后,在提交、防抖或失焦时,一次性
store.$patch({ name, email, phone })
这样既保证响应性,又避免因频繁小更新带来的性能损耗。
需要重置或替换整个 state 时的处理方式
如果 action 目标是恢复初始状态或完全替换数据:
- Options Store 可直接调用内置
this.$reset() - Setup Store 没有内置
$reset,需手动定义一个 reset action:reset() { this.$state = { ...initialState } } - 也可用
this.$state = {...}替换全部字段(本质调用的是$patch)
注意:直接赋值 this.xxx = yyy 虽然可行,但破坏了逻辑收敛性,不利于调试和维护。










