Vuex入门

在 vue 开发中，组件通信一直是一大痛点。

当项目是很简单的 SPA 或者多入口项目时，可以靠着 vue 自带的 prop/$emit 进行组件通信；规模再大一些，可以搭配使用 bus 总线进行兄弟组件通信；项目再大一些，出现更复杂的组件关系时，复杂的组件通信可以让你写得怀疑人生。

万幸的是， vue 官方出品了 vuex ，通过全局式的状态管理，解决了这一痛点。

虽然 vuex 很好用，但是，很多小伙伴和我吐槽 vuex 的文档和 vue-ssr 的文档一样，让人看得一脸懵逼。

好吧，下面就让我来带着大家一起入门 vuex 。

安装并引入

正常情况下，我们使用 vue-cli3 生成项目时，可以选择集成 vuex 到项目中。此时， vue-cli3 会自动安装 vuex ，并在 src 文件夹下生成 store.js 完成 vuex 的引入和配置。

但是，很多同学并没有使用 vue-cli3 或者生成项目时没有选择集成 vuex 。此时，就只能手动安装并引入 vuex 了。

安装

由于 vuex 是用于全局状态管理的，所以，它不仅仅作用于开发环境，而且还要用于生产环境。

显而易见，安装 vuex 应该使用 -S 即 --save 命令。

npm install vuex -S

引入

类似于 vue-cli3 生成的项目，我们在 src 文件夹下新建 store.js ，并在其中写入：

// store.js
import Vue from 'vue'
import Vuex from 'vuex'

Vue.use(Vuex)

export default new Vuex.Store({})

然后，我们只需要在 vue 实例中引入 store.js 中的 Vuex.Store 实例即可：

// main.js
import Vue from 'vue'
import App from './App.vue'
import router from './router'
import store from './store'

Vue.config.productionTip = false

new Vue({
  router,
  // 引入store
  store,
  render: h => h(App)
}).$mount('#app')

Vuex的使用

完成了 vuex 的安装和引入，接下来我们进入 Vuex 的使用。

vuex 中有三要素： state， mutation 以及 action 。它们之间的关系可以用官网那张著名的图来表示：

State

简单来说， state 表示状态，类似于 vue 中的 data （其实本质上就是差不多的， vuex 在 vue 的 beforeCreate 钩子中将 state 混入进 data）。但是，它们又有很大的不同： 在使用者看来， state 是全局的，这得益于 vuex 的设计理念——单一状态树。这些我将在后几篇文章中详细，现在我们只需要知道 state 是类似于全局下的 data 。

接下来我们通过一个简单例子来感受下 state ：

首先，我们需要修改 store.js 文件，配置 state 。可以看到，我们在生成 Vuex.Store 实例时传入了实例化选项对象，对象包含一个 state 属性， state 对象的属性就是我们定义的全局状态。

此时，我们定义了一个全局状态——count ，并将其的初始值设为1 。

// store.js
import Vue from 'vue'
import Vuex from 'vuex'

Vue.use(Vuex)

export default new Vuex.Store({
  // 添加state
  state: {
    count: 1
  }
})

接下来，我们需要在组件中引用 count，由于它是全局状态，我们可以在任何一个组件中使用。为了展示其威力，我们在两个不同的组件中使用它。

首先我们在 App.vue 中使用它：

在模板中，我们使用 $store.state.count 引入该全局状态，没错，使用它就是那么简单，只需要 以 $store.state.key 的形式调用。

// App.vue
<template>
  <div id="app">
    <div id="nav">
      {{$store.state.count}}
      <router-link to="/">Home</router-link> |
      <router-link to="/about">About</router-link>
    </div>
    <router-view/>
  </div>
</template>

可以发现， Home 前多出了一个 1 ，这代表着我们成功引入了全局状态 count 。

接下来我们在 Home.vue 的子组件 HelloWorld.vue 中引入 count 。

相同的引用方式： $store.state.count

// HelloWorld.vue
<template>
  <div class="hello">
    {{$store.state.count}}
  </div>
</template>

可以发现，页面中又多出了一个 1 ，代表着我们又一次引用成功。现在，是不是已经感受到了 vuex 的威力？

Mutation

但是，上面的示例有个问题，那就是全局状态是静态的。如果在实际应用场景中，一般来说，会经常更改状态。

有的同学会说，我们直接在方法中修改 this.$store.state.key 的值不就行了吗？

不好意思，当然是不行的。

state 和 data 的另一大区别在于，你不能直接改变 state 。改变 store 中的状态的唯一途径就是显式地提交 (commit) mutation。这样使得我们可以方便地跟踪每一个状态的变化，从而让我们能够实现一些工具帮助我们更好地了解我们的应用。

简而言之，我们把 mutation 当做接收 state 作为参数并修改 state 的自定义事件即可，上一段所说的 commit 就是触发 mutaion 这个自定义事件的方法。

光说不练假把式，接下来，我们对为 vuex 添加上 mutation ，实现 state 的动态改变：

首先，当然是修改生成 Vuex.Store 示例的选项对象，为其添加 mutations 。

import Vue from 'vue'
import Vuex from 'vuex'

Vue.use(Vuex)

export default new Vuex.Store({
  state: {
    count: 1
  },
  // 添加mutation
  mutations: {
    increment (state) {
      state.count++
    }
  }
})

在上面的代码中，我们添加了一个名为 increment 的 mutation 。完成了自定义事件，接下来，我们只需要在组件中对 mutation 进行触发即可。

我们在 HelloWorld.vue 添加一个按钮，每次点击触发一次 increment 这个 mutation 。可以发现，触发方式很简单，只需要调用 store 自带的 commit 方法，其中参数为需要触发的 mutation 的名称。

// HelloWorld.vue
<template>
  <div class="hello">
    <div>{{$store.state.count}}</div>
    <button @click="$store.commit('increment')">修改count</button>
  </div>
</template>

点击页面中的按钮，你会发现，页面中的两个 count 都同时增加了1，说明我们成功实现了 state 的动态修改。

Action

action 类似于 mutation ，也相当于一种自定义事件。只不过， action 操作的是 mutation 而不是 state 。

添加 action 的方法类似，在选项对象中新增 action 属性即可。与 mutation 的参数不同， action 的参数就是当前创建的 Vue.store 对象实例的上下文，一般将其命名为 context 。我们需要使用其自带的 commit 方法来触发 mutation 。

下面我通过实际的例子来尝试下 action ：

首先，修改选项对象，使得新添加的 action 可以触发之前的 mutation ：

// store.js
import Vue from 'vue'
import Vuex from 'vuex'

Vue.use(Vuex)

export default new Vuex.Store({
  state: {
    count: 1
  },
  mutations: {
    increment (state) {
      state.count++
    }
  },
  actions: {
    increment ({ commit }) {
      commit('increment')
    }
  }
})

由于我们一般来说仅仅需要 context 中的 commit 方法，所以可以采用解构的方式，直接调用 commit 方法，而不需要以 context.commit 的方式使用它。

接下来，只需要修改 HelloWorld.vue ，使其能够在点击按钮时触发即可。

action 的触发方式和 mutation 类似，只不过调用的方法是 dispatch 。

// HelloWorld.vue
<template>
  <div class="hello">
    <div>{{$store.state.count}}</div>
    <button @click="$store.dispatch('increment')">修改count</button>
  </div>
</template>

点击页面按钮，你会发现，实现了和之前相同的效果。

总结

学会了 vuex 三贱客： state ， mutation ， action ，我们再回过头看看前面的那张关系图，此时应该很容易理解了吧？

组件交互触发 action ， 在 action 中进行异步操作（可选）并触发 mutation ， mutation 控制 state 的变动， state 修改之后，触发响应式，重新渲染组件。

彩蛋

在官方文档中，提到需要将异步操作放入 action 中，而不能放在 mutation 中。实际上，在 mutation 中也可以进行异步操作，而且也不会导致什么奇怪的事情。

但是，既然官方文档中这么说了，我们在实际开发中，一般还是老老实实地将所有异步操作放在 action 中。（猥琐保平安 -_-）

另外，说了这么多，其实在一些项目中，可以使用 provide/inject 代替 vuex 。具体的用法在此不再赘述，就当一个课后作业吧。

在项目中灵活使用 provide/inject ，有时可以起到出乎意料的作用哦。

最后的最后

篇幅有限，所以该篇文章只讲述了 vuex 三贱客的基本用法，其他的进阶用法，如： getter ， module ， 简写以及 vuex 项目结构优化，甚至 vuex 源码解析将会在之后的文章一一讲解。

如果您觉得这片文章不错的话，不如给我的 gayhub 点个star再走呗。

这个项目个人认为对很多新手在实际开发中使用 vuex 还是很有启发和帮助的（手动狗头）。

欢迎交流，谢谢~