Vuex中同步修改state必须通过Mutations,它是唯一合法入口;Actions仅用于封装异步或复杂逻辑,并通过commit调用Mutations间接更新state,本身不直接修改state。

Vue 状态更新流程中,并不是“必须”通过 Actions 修改状态,而是当涉及异步操作或复杂业务逻辑时,应当通过 Actions 来组织流程,再由 Actions 提交 Mutations 去真正修改 state。直接修改 state 是被禁止的,而同步修改必须走 Mutations;Actions 本身不改 state,只负责调度和封装逻辑。
一、Mutations 才是唯一能改 state 的入口
Mutations 是 Vuex 中唯一允许同步变更 state 的地方。它的设计是原子性、可追踪、可调试的:
- 每个 mutation 必须是纯函数:只接收 state 和 payload,不执行副作用(如 API 请求、setTimeout)
- Vuex 依赖 mutation 的提交记录来实现时间旅行调试、状态快照、devtools 集成
- 开启严格模式(
strict: true)后,任何绕过 mutation 的 state 修改都会抛出错误
二、Actions 解决的是 Mutations 不能做的事
Mutations 不支持异步,但真实业务中大量操作天然异步(比如登录、拉取用户信息、上传文件)。Actions 的存在,就是为了解耦和承接这些场景:
- 可以包含任意异步代码(
axios、setTimeout、async/await) - 可在异步成功后调用
commit('xxx'),也可在失败时统一处理错误 - 支持组合多个 mutation,例如:先
commit('setLoading', true),再请求,最后根据结果 commit 成功或失败状态 - 返回 Promise,便于组件中用
.then()或await dispatch('fetchUser')控制后续行为
三、不走 Actions 的代价是什么?
如果强行在组件里写异步逻辑并直接改 state(比如 this.$store.state.user = res.data):
立即学习“前端免费学习笔记(深入)”;
- Vue 响应式可能失效(尤其深层属性未被 Vue.set 包裹时)
- devtools 无法记录这次变更,调试时看不到“谁、何时、为什么改了状态”
- 无法回滚、重放、导出快照,丧失 Vuex 的核心可观测性优势
- 多人协作时逻辑散落在组件中,难以复用、测试和维护
四、什么时候可以不用 Actions?
简单同步操作完全可以直接 dispatch 一个 action,内部只 commit 一个 mutation —— 这仍是推荐写法;但如果你的逻辑:
- 不涉及异步、无副作用、无条件分支
- 且仅在一个地方使用、无复用需求
- 你也可以在组件中直接
this.$store.commit('increment')
只是要注意:这种写法会弱化状态变更的可追溯性,大型项目中不建议。


















