Vuex

1、概念

1.1Vuex是什么？

Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式 + 库。它采用集中式存储管理应用的所有组件的状态，并以相应的规则保证状态以一种可预测的方式发生变化。

简单俩说，它就是解决我们组件共享之间的vue插件！

1.2、那么什么是状态管理模式？

 const Counter = {
   // 状态
   data () {
     return {
       count: 0
     }
   },
   // 视图
   template: `
     <div>{{ count }}</div>
   `,
   // 操作
   methods: {
     increment () {
       this.count++
     }
   }
 }
 ​
 createApp(Counter).mount('#app')

这个状态自管理应用包含以下几个部分：

• 状态，驱动应用的数据源；

• 视图，以声明方式将状态映射到视图；

• 操作，响应在视图上的用户输入导致的状态变化。

以下是一个表示“单向数据流”理念的简单示意：

但是，当我们的应用遇到多个组件共享状态时，单向数据流的简洁性很容易被破坏：

• 多个视图依赖于同一状态。

• 来自不同视图的行为需要变更同一状态。

在上面的图示，可以知道我们的数据都是放在state中的，然后供我们Vue组件使用，但是这里为什么要定义 Actions/ Mutations，

这里Actions / Mutations 都是对data数据的改变，但是Actions是对数据的间接改变，而Mutations是对数据的直接改变！

总结：

• vue其实就是vue页面组件数据共享的一个插件！

• 如果对vuex不理解的话，可以理解为Java中的session。可以共享数据。而这里的vuex共享的数据是给所有页面组件使用的。而Java中session共享的数据是给所有的类使用的！

1.3、什么情况下使用vuex？

Vuex 可以帮助我们管理共享状态，并附带了更多的概念和框架。这需要对短期和长期效益进行权衡。

如果您不打算开发大型单页应用，使用 Vuex 可能是繁琐冗余的。确实是如此——如果您的应用够简单，您最好不要使用 Vuex。一个简单的 store 模式就足够您所需了。但是，如果您需要构建一个中大型单页应用，您很可能会考虑如何更好地在组件外部管理状态，Vuex 将会成为自然而然的选择。

1.3、安装，项目搭建

在这里是基于vue3，基于vue-cli脚手架进行安装下载：

安装：

这里要确保已将安装了yarn，否则我们在使用yarn进行安装会报如下错误：Vue创建项目页面报错Cannot read properties of undefined (reading ‘indexOf‘)

参考博客：https://blog.csdn.net/D_Zhou_Sir/article/details/124946646

yarn global add @vue/cli

 npm install -g @vue/cli
 # OR
 yarn global add @vue/cli

创建一个项目：

 vue create my-project
 # OR
 vue ui

输入之后进入图行界面的页面：

这里创建选择vue3，然后输入名字，下一步即可！

然后就会生成如下界面：

当然就这样还是不够的，需要下载插件：（Plugins）

接下来我们就可以实现正常的使用了！点击sever运行服务即可正常访问！

在这里遇到一个坑那就是devtools插件，本来想着下载这个方便一点，但是导致程序报错，启动失败！（如果报错了，那么请去打开vscode删除对应的依赖！）

在使用vue ui进行页面的创建的时候，发现自己的版本不是基于vue3，然后进行创建vue2也不行，然后遇到这个问题！vue 创建项目 Cannot set property ‘context‘ of null，遇到的问题，参考博客：

https://blog.csdn.net/enkidu_gachi/article/details/123569042

对于store / index.js了解！

 import { createStore } from 'vuex'
 ​
 // 1:导入vuex的模块
 ​
 // 2:注册vuex插件到vue中，这里就是全局注册
 // 3:开始给vuex中定义响应式全局数据共享对象 this.$store
 ​
 export default createStore({
   // 4: 定义响应式的数据，就类似于data，只不过是全局
   state: {
     // 状态管理的数据！
     count: 0
   },
   // 5： 可以认为是 store 的计算属性，对state管理的一种过滤处理的机制！
   getters: {
   },
   // 6 ：定义改变state数据的行为,可以直接修改state的数据
   mutations: {
     // 改变state的数据状态！
     increment (state) {
       state.count++
     }
   },
   // 7：actions是处理异步数据和提交mutations的机制。简介改变state
   // 注意：不能直接更改state的数据。更改的方式通过commit('mutations定义的事件')
   actions: {
     
   },
   // 8：模块化隔离的一种机制！
   modules: {
   }
 })

2、核心

2.1、state

1、定义state

遵循vue的语法一样的规则！

   state: {
     // 状态管理的数据！
     count: 0
   },

2、如何改变state

主要通过mutation（直接改变）和actions（间接改变）

 // 在store/index.js定义如下
 // 可以改变state管理的数据
 // 执行的方式是 this.$store.commit('increment')
 mutations: {
     // 改变state的数据状态！
     increment (state) {
       state.count++
     }
   },
   // 注意：不能直接更改state的数据。更改的方式通过commit('mutations定义的事件')
   // 执行的方式是 this.$store.dispatch('increment')
   actions: {
     increment (context){
       context.commit("increment")
     }
   },

3、在Vue组件中获取vuex状态

那么我们如何在 Vue 组件中展示状态呢？由于 Vuex 的状态存储是响应式的，从 store 实例中读取状态最简单的方法就是在计算属性中返回某个状态：

我们如果想要 使用/变更 store中定义好的，应该怎么做呢？

• 使用：this.$store.state.xxx(xxx就是你要使用的！)

• 改变：this.$store.commit(“x”)（mutations中定义的方法，就是这里要使用的！）

只要在我们需要使用的页面进行如下操作！定义在computed中

   computed: {
     count (){
       return this.$store.state.count;
     }
   }

那么这里有一个问题，那就是我们不定义在这里难道不可以吗？

答案当然是可以的，只不过，如果我们不定义在这里的话，那么我们的数据就不是响应式的，可以实验下面的案例进行验证！

每当 store.state.count 变化的时候, 都会重新求取计算属性，并且触发更新相关联的 DOM。

store / index.js

 import { createStore } from 'vuex'
 ​
 // 1:导入vuex的模块
 ​
 // 2:注册vuex插件到vue中，这里就是全局注册
 // 3:开始给vuex中定义响应式全局数据共享对象 this.$store
 ​
 export default createStore({
   // 4: 定义响应式的数据，就类似于data，只不过是全局
   state: {
     // 状态管理的数据！
     count: 100
   },
   // 5： 可以认为是 store 的计算属性，对state管理的一种过滤处理的机制！
   getters: {
   },
   // 6 ：定义改变state数据的行为,可以直接修改state的数据
   mutations: {
     // 改变state的数据状态！
     increment (state) {
       state.count++
     }
   },
   // 7：actions是处理异步数据和提交mutations的机制。简介改变state
   // 注意：不能直接更改state的数据。更改的方式通过commit('mutations定义的事件')
   actions: {
     increment (context){
       context.commit("increment")
     }
   },
   // 8：模块化隔离的一种机制！
   modules: {
   }
 })

例如在homeview中进行使用：

 <template>
   <div class="home">
     <img alt="Vue logo" src="../assets/logo.png">
     <HelloWorld msg="Welcome to Your Vue.js App"/>
     当前的数量为：{{count}}--{{zcount}}
     <button @click="addcount">按钮</button>
   </div>
 </template>
 ​
 <script>
 // @ is an alias to /src
 import HelloWorld from '@/components/HelloWorld.vue'
 ​
 export default {
   name: 'HomeView',
   components: {
     HelloWorld
   },
   data(){
     return{
       zcount:this.$store.state.count
     }
   },
   created(){
     console.log(this);
   },
   // 这里可以不定义在computed中吗？当然是可以的！只不过不定义在这里的话就不是响应式的！
   computed: {
     count (){
       return this.$store.state.count;
     }
   },
   // 事件定义的位置
   methods:{
     // 1. 定义count累加，改变vuex的状态！
     addcount(){
       this.$store.commit("increment")
     }
   }
 }
 </script>

mapState 辅助函数

当一个组件需要获取多个状态的时候，将这些状态都声明为计算属性会有些重复和冗余。为了解决这个问题，我们可以使用 mapState 辅助函数帮助我们生成计算属性，让你少按几次键：

 // 在单独构建的版本中辅助函数为 Vuex.mapState
 import { mapState } from 'vuex'
 ​
 export default {
   // ...
   computed: mapState({
     // 箭头函数可使代码更简练
     count: state => state.count,
 ​
     // 传字符串参数 'count' 等同于 `state => state.count`
     countAlias: 'count',
 ​
     // 为了能够使用 `this` 获取局部状态，必须使用常规函数
     countPlusLocalState (state) {
       return state.count + this.localCount
     }
   })
 }

当映射的计算属性的名称与 state 的子节点名称相同时，我们也可以给 mapState 传一个字符串数组。

 computed: mapState([
   // 映射 this.count 为 store.state.count
   'count'
 ])

对象展开运算符

mapState 函数返回的是一个对象。我们如何将它与局部计算属性混合使用呢？通常，我们需要使用一个工具函数将多个对象合并为一个，以使我们可以将最终对象传给 computed 属性。但是自从有了对象展开运算符，我们可以极大地简化写法：

 computed: {
   localComputed () { /* ... */ },
   // 使用对象展开运算符将此对象混入到外部对象中
   ...mapState({
     // ...
   })
 }

2.2、Mutations

更改 Vuex 的 store 中的状态的唯一方法是提交 mutation。Vuex 中的 mutation 非常类似于事件：每个 mutation 都有一个字符串的事件类型 (type)*和一个*回调函数 (handler)。这个回调函数就是我们实际进行状态更改的地方，并且它会接受 state 作为第一个参数：

 const store = createStore({
   state: {
     count: 1
   },
   mutations: {
     increment (state) {
       // 变更状态
       state.count++
     }
   }
 })

你不能直接调用一个 mutation 处理函数。这个选项更像是事件注册：“当触发一个类型为 increment 的 mutation 时，调用此函数。”要唤醒一个 mutation 处理函数，你需要以相应的 type 调用 store.commit 方法：

 store.commit('increment')

提交载荷（Payload）

你可以向 store.commit 传入额外的参数，即 mutation 的载荷（payload）：

 // ...
 mutations: {
   increment (state, n) {
     state.count += n
   }
 }

 store.commit('increment', 10)

在大多数情况下，载荷应该是一个对象，这样可以包含多个字段并且记录的 mutation 会更易读：

 // ...
 mutations: {
   increment (state, payload) {
     state.count += payload.amount
   }
 }

 store.commit('increment', {
   amount: 10
 })

对象风格的提交方式

提交 mutation 的另一种方式是直接使用包含 type 属性的对象：

 store.commit({
   type: 'increment',
   amount: 10
 })

当使用对象风格的提交方式，整个对象都作为载荷传给 mutation 函数，因此处理函数保持不变：

 mutations: {
   increment (state, payload) {
     state.count += payload.amount
   }
 }

使用常量代替 Mutation事件类型

使用常量替代 mutation 事件类型在各种 Flux 实现中是很常见的模式。这样可以使 linter 之类的工具发挥作用，同时把这些常量放在单独的文件中可以让你的代码合作者对整个 app 包含的 mutation 一目了然：

 // mutation-types.js
 export const SOME_MUTATION = 'SOME_MUTATION'

 // store.js
 import { createStore } from 'vuex'
 import { SOME_MUTATION } from './mutation-types'
 ​
 const store = createStore({
   state: { ... },
   mutations: {
     // 我们可以使用 ES2015 风格的计算属性命名功能
     // 来使用一个常量作为函数名
     [SOME_MUTATION] (state) {
       // 修改 state
     }
   }
 })

Mutation 必须是同步函数

一条重要的原则就是要记住 mutation 必须是同步函数。为什么？请参考下面的例子：

 mutations: {
   someMutation (state) {
     api.callAsyncMethod(() => {
       state.count++
     })
   }
 }

现在想象，我们正在 debug 一个 app 并且观察 devtool 中的 mutation 日志。每一条 mutation 被记录，devtools 都需要捕捉到前一状态和后一状态的快照。然而，在上面的例子中 mutation 中的异步函数中的回调让这不可能完成：因为当 mutation 触发的时候，回调函数还没有被调用，devtools 不知道什么时候回调函数实际上被调用——实质上任何在回调函数中进行的状态的改变都是不可追踪的。

在组件中提交 Mutation

你可以在组件中使用 this.$store.commit('xxx') 提交 mutation，或者使用 mapMutations 辅助函数将组件中的 methods 映射为 store.commit 调用（需要在根节点注入 store）。

 import { mapMutations } from 'vuex'
 ​
 export default {
   // ...
   methods: {
     ...mapMutations([
       'increment', // 将 `this.increment()` 映射为 `this.$store.commit('increment')`
 ​
       // `mapMutations` 也支持载荷：
       'incrementBy' // 将 `this.incrementBy(amount)` 映射为 `this.$store.commit('incrementBy', amount)`
     ]),
     ...mapMutations({
       add: 'increment' // 将 `this.add()` 映射为 `this.$store.commit('increment')`
     })
   }
 }

2.3、Action

Action 类似于 mutation，不同在于：

• Action 提交的是 mutation，而不是直接变更状态。

• Action 可以包含任意异步操作。

 const store = createStore({
   state: {
     count: 0
   },
   mutations: {
     increment (state) {
       state.count++
     }
   },
   actions: {
     increment (context) {
       context.commit('increment')
     }
   }
 })

Action 函数接受一个与 store 实例具有相同方法和属性的 context 对象，因此你可以调用 context.commit 提交一个 mutation，或者通过 context.state 和 context.getters 来获取 state 和 getters。

实践中，我们会经常用到 ES2015 的参数解构来简化代码（特别是我们需要调用 commit 很多次的时候）：

 actions: {
   increment ({ commit }) {
     commit('increment')
   }
 }

分发Action

Action 通过 store.dispatch 方法触发：

 store.dispatch('increment')

乍一眼看上去感觉多此一举，我们直接分发 mutation 岂不更方便？实际上并非如此，还记得 mutation 必须同步执行这个限制么？Action 就不受约束！我们可以在 action 内部执行异步操作：

 actions: {
   incrementAsync ({ commit }) {
     setTimeout(() => {
       commit('increment')
     }, 1000)
   }
 }

Actions 支持同样的载荷方式和对象方式进行分发：

 // 以载荷形式分发
 store.dispatch('incrementAsync', {
   amount: 10
 })
 ​
 // 以对象形式分发
 store.dispatch({
   type: 'incrementAsync',
   amount: 10
 })

来看一个更加实际的购物车示例，涉及到调用异步 API 和分发多重 mutation：

 actions: {
   checkout ({ commit, state }, products) {
     // 把当前购物车的物品备份起来
     const savedCartItems = [...state.cart.added]
     // 发出结账请求
     // 然后乐观地清空购物车
     commit(types.CHECKOUT_REQUEST)
     // 购物 API 接受一个成功回调和一个失败回调
     shop.buyProducts(
       products,
       // 成功操作
       () => commit(types.CHECKOUT_SUCCESS),
       // 失败操作
       () => commit(types.CHECKOUT_FAILURE, savedCartItems)
     )
   }
 }

注意我们正在进行一系列的异步操作，并且通过提交 mutation 来记录 action 产生的副作用（即状态变更）。

在组件中分发Action

你在组件中使用 this.$store.dispatch('xxx') 分发 action，或者使用 mapActions 辅助函数将组件的 methods 映射为 store.dispatch 调用（需要先在根节点注入 store）：

 import { mapActions } from 'vuex'
 ​
 export default {
   // ...
   methods: {
     ...mapActions([
       'increment', // 将 `this.increment()` 映射为 `this.$store.dispatch('increment')`
 ​
       // `mapActions` 也支持载荷：
       'incrementBy' // 将 `this.incrementBy(amount)` 映射为 `this.$store.dispatch('incrementBy', amount)`
     ]),
     ...mapActions({
       add: 'increment' // 将 `this.add()` 映射为 `this.$store.dispatch('increment')`
     })
   }
 }

组合 Action

Action 通常是异步的，那么如何知道 action 什么时候结束呢？更重要的是，我们如何才能组合多个 action，以处理更加复杂的异步流程？

首先，你需要明白 store.dispatch 可以处理被触发的 action 的处理函数返回的 Promise，并且 store.dispatch 仍旧返回 Promise：

 actions: {
   actionA ({ commit }) {
     return new Promise((resolve, reject) => {
       setTimeout(() => {
         commit('someMutation')
         resolve()
       }, 1000)
     })
   }
 }

现在你可以：

 store.dispatch('actionA').then(() => {
   // ...
 })

在另外一个 action 中也可以：

 actions: {
   // ...
   actionB ({ dispatch, commit }) {
     return dispatch('actionA').then(() => {
       commit('someOtherMutation')
     })
   }
 }

最后，如果我们利用 async / await，我们可以如下组合 action：

 // 假设 getData() 和 getOtherData() 返回的是 Promise
 ​
 actions: {
   async actionA ({ commit }) {
     commit('gotData', await getData())
   },
   async actionB ({ dispatch, commit }) {
     await dispatch('actionA') // 等待 actionA 完成
     commit('gotOtherData', await getOtherData())
   }
 }

一个 store.dispatch 在不同模块中可以触发多个 action 函数。在这种情况下，只有当所有触发函数完成后，返回的 Promise 才会执行。

案例：

在这里我们假如要有一个登录请求：

 import { createStore } from 'vuex'
 ​
 // 1:导入vuex的模块
 ​
 // 2:注册vuex插件到vue中，这里就是全局注册
 // 3:开始给vuex中定义响应式全局数据共享对象 this.$store
 ​
 export default createStore({
   // 4: 定义响应式的数据，就类似于data，只不过是全局
   state: {
     // 状态管理的数据！
     count: 100,
     user: {
       nickName:"",
       password:""
     }
   },
   // 5： 可以认为是 store 的计算属性，对state管理的一种过滤处理的机制！
   getters: {
   },
   // 6 ：定义改变state数据的行为,可以直接修改state的数据
   mutations: {
     // 改变state的数据状态！
     increment (state) {
       state.count++
     },
     changeuser(state,params){
       state.user.nickName = params.nickName
       state.user.password = params.password
     }
   },
   // 7：actions是处理异步数据和提交mutations的机制。简介改变state
   // 注意：不能直接更改state的数据。更改的方式通过commit('mutations定义的事件')
   actions: {
     // 改变state的数据状态，车间
     // increment (context){
     //  移除处理
     //   context.commit("increment")
     // }
 ​
     increment({commit}){
       // 异步处理
       commit("increment")
     },
 ​
     //登录逻辑
     login({commit},params){
       commit('changeuser',params);
     }
     
   },
   // 8：模块化隔离的一种机制！
   modules: {
   }
 })

然后进行使用：

 <template>
   <div class="home">
     <img alt="Vue logo" src="../assets/logo.png">
     <HelloWorld msg="Welcome to Your Vue.js App"/>
     当前的数量为：{{count}}--{{zcount}}
     <button @click="addcount">按钮</button>
     当前用户为：{{user.nickName}}
   </div>
 </template>
 ​
 <script>
 // @ is an alias to /src
 import HelloWorld from '@/components/HelloWorld.vue'
 ​
 export default {
   name: 'HomeView',
   components: {
     HelloWorld
   },
   data(){
     return{
       zcount:this.$store.state.count
     }
   },
   created(){
     console.log(this);
   },
   // 这里可以不定义在computed中吗？当然是可以的！只不过不定义在这里的话就不是响应式的！
   computed: {
     count (){
       return this.$store.state.count;
     },
     user(){
       return this.$store.state.user;
     }
   },
   // 事件定义的位置
   methods:{
     // 1. 定义count累加，改变vuex的状态！
     addcount(){
       // this.$store.commit("increment")
       var nickName = "admin";
       var password = "123456";
 ​
       this.$store.dispatch('login', {nickName,password})
     }
   }
 }
 </script>
 ​

这里是单页面的测试！试想一下，如果我们有很多页面都要进行使用呢？那么不是要写很多吗？所以这种情况下我们就要把他抽取出来定义一个Login.vue，方便我们多个页面之间进行复用！

2.4、Getter

有时候我们需要从 store 中的 state 中派生出一些状态，例如对列表进行过滤并计数：

 computed: {
   doneTodosCount () {
     return this.$store.state.todos.filter(todo => todo.done).length
   }
 }

如果有多个组件需要用到此属性，我们要么复制这个函数，或者抽取到一个共享函数然后在多处导入它——无论哪种方式都不是很理想。

Vuex 允许我们在 store 中定义“getter”（可以认为是 store 的计算属性）。

Getter 接受 state 作为其第一个参数：

 const store = createStore({
   state: {
     todos: [
       { id: 1, text: '...', done: true },
       { id: 2, text: '...', done: false }
     ]
   },
   getters: {
     doneTodos (state) {
       return state.todos.filter(todo => todo.done)
     }
   }
 })

通过属性访问

Getter 会暴露为 store.getters 对象，你可以以属性的形式访问这些值：

 store.getters.doneTodos // -> [{ id: 1, text: '...', done: true }]

Getter 也可以接受其他 getter 作为第二个参数：

 getters: {
   // ...
   doneTodosCount (state, getters) {
     return getters.doneTodos.length
   }
 }
 store.getters.doneTodosCount // -> 1

我们可以很容易地在任何组件中使用它：

 computed: {
   doneTodosCount () {
     return this.$store.getters.doneTodosCount
   }
 }

注意，getter 在通过属性访问时是作为 Vue 的响应式系统的一部分缓存其中的。

通过方法访问

你也可以通过让 getter 返回一个函数，来实现给 getter 传参。在你对 store 里的数组进行查询时非常有用。

 getters: {
   // ...
   getTodoById: (state) => (id) => {
     return state.todos.find(todo => todo.id === id)
   }
 }
 store.getters.getTodoById(2) // -> { id: 2, text: '...', done: false }

注意，getter 在通过方法访问时，每次都会去进行调用，而不会缓存结果。

mapGetters 辅助函数

mapGetters 辅助函数仅仅是将 store 中的 getter 映射到局部计算属性：

 import { mapGetters } from 'vuex'
 ​
 export default {
   // ...
   computed: {
   // 使用对象展开运算符将 getter 混入 computed 对象中
     ...mapGetters([
       'doneTodosCount',
       'anotherGetter',
       // ...
     ])
   }
 }

如果你想将一个 getter 属性另取一个名字，使用对象形式：

 ...mapGetters({
   // 把 `this.doneCount` 映射为 `this.$store.getters.doneTodosCount`
   doneCount: 'doneTodosCount'
 })

2.5、Module

由于使用单一状态树，应用的所有状态会集中到一个比较大的对象。当应用变得非常复杂时，store 对象就有可能变得相当臃肿。

为了解决以上问题，Vuex 允许我们将 store 分割成模块（module）。每个模块拥有自己的 state、mutation、action、getter、甚至是嵌套子模块——从上至下进行同样方式的分割：

 const moduleA = {
   state: () => ({ ... }),
   mutations: { ... },
   actions: { ... },
   getters: { ... }
 }
 ​
 const moduleB = {
   state: () => ({ ... }),
   mutations: { ... },
   actions: { ... }
 }
 ​
 const store = createStore({
   modules: {
     a: moduleA,
     b: moduleB
   }
 })
 ​
 store.state.a // -> moduleA 的状态
 store.state.b // -> moduleB 的状态

模块的局部状态

对于模块内部的 mutation 和 getter，接收的第一个参数是模块的局部状态对象。

 const moduleA = {
   state: () => ({
     count: 0
   }),
   mutations: {
     increment (state) {
       // 这里的 `state` 对象是模块的局部状态
       state.count++
     }
   },
   getters: {
     doubleCount (state) {
       return state.count * 2
     }
   }
 }

同样，对于模块内部的 action，局部状态通过 context.state 暴露出来，根节点状态则为 context.rootState：

 const moduleA = {
   // ...
   actions: {
     incrementIfOddOnRootSum ({ state, commit, rootState }) {
       if ((state.count + rootState.count) % 2 === 1) {
         commit('increment')
       }
     }
   }
 }

对于模块内部的 getter，根节点状态会作为第三个参数暴露出来：

 const moduleA = {
   // ...
   getters: {
     sumWithRootCount (state, getters, rootState) {
       return state.count + rootState.count
     }
   }
 }

命名空间

默认情况下，模块内部的 action 和 mutation 仍然是注册在全局命名空间的——这样使得多个模块能够对同一个 action 或 mutation 作出响应。Getter 同样也默认注册在全局命名空间，但是目前这并非出于功能上的目的（仅仅是维持现状来避免非兼容性变更）。必须注意，不要在不同的、无命名空间的模块中定义两个相同的 getter 从而导致错误。

如果希望你的模块具有更高的封装度和复用性，你可以通过添加 namespaced: true 的方式使其成为带命名空间的模块。当模块被注册后，它的所有 getter、action 及 mutation 都会自动根据模块注册的路径调整命名。例如：

 const store = createStore({
   modules: {
     account: {
       namespaced: true,
 ​
       // 模块内容（module assets）
       state: () => ({ ... }), // 模块内的状态已经是嵌套的了，使用 `namespaced` 属性不会对其产生影响
       getters: {
         isAdmin () { ... } // -> getters['account/isAdmin']
       },
       actions: {
         login () { ... } // -> dispatch('account/login')
       },
       mutations: {
         login () { ... } // -> commit('account/login')
       },
 ​
       // 嵌套模块
       modules: {
         // 继承父模块的命名空间
         myPage: {
           state: () => ({ ... }),
           getters: {
             profile () { ... } // -> getters['account/profile']
           }
         },
 ​
         // 进一步嵌套命名空间
         posts: {
           namespaced: true,
 ​
           state: () => ({ ... }),
           getters: {
             popular () { ... } // -> getters['account/posts/popular']
           }
         }
       }
     }
   }
 })

启用了命名空间的 getter 和 action 会收到局部化的 getter，dispatch 和 commit。换言之，你在使用模块内容（module assets）时不需要在同一模块内额外添加空间名前缀。更改 namespaced 属性后不需要修改模块内的代码。

在带命名空间的模块内访问全局内容（Global Assets

如果你希望使用全局 state 和 getter，rootState 和 rootGetters 会作为第三和第四参数传入 getter，也会通过 context 对象的属性传入 action。

若需要在全局命名空间内分发 action 或提交 mutation，将 { root: true } 作为第三参数传给 dispatch 或 commit 即可。

 modules: {
   foo: {
     namespaced: true,
 ​
     getters: {
       // 在这个模块的 getter 中，`getters` 被局部化了
       // 你可以使用 getter 的第四个参数来调用 `rootGetters`
       someGetter (state, getters, rootState, rootGetters) {
         getters.someOtherGetter // -> 'foo/someOtherGetter'
         rootGetters.someOtherGetter // -> 'someOtherGetter'
         rootGetters['bar/someOtherGetter'] // -> 'bar/someOtherGetter'
       },
       someOtherGetter: state => { ... }
     },
 ​
     actions: {
       // 在这个模块中， dispatch 和 commit 也被局部化了
       // 他们可以接受 `root` 属性以访问根 dispatch 或 commit
       someAction ({ dispatch, commit, getters, rootGetters }) {
         getters.someGetter // -> 'foo/someGetter'
         rootGetters.someGetter // -> 'someGetter'
         rootGetters['bar/someGetter'] // -> 'bar/someGetter'
 ​
         dispatch('someOtherAction') // -> 'foo/someOtherAction'
         dispatch('someOtherAction', null, { root: true }) // -> 'someOtherAction'
 ​
         commit('someMutation') // -> 'foo/someMutation'
         commit('someMutation', null, { root: true }) // -> 'someMutation'
       },
       someOtherAction (ctx, payload) { ... }
     }
   }
 }

在带命名空间的模块注册全局 action

若需要在带命名空间的模块注册全局 action，你可添加 root: true，并将这个 action 的定义放在函数 handler 中。例如：

 {
   actions: {
     someOtherAction ({dispatch}) {
       dispatch('someAction')
     }
   },
   modules: {
     foo: {
       namespaced: true,
 ​
       actions: {
         someAction: {
           root: true,
           handler (namespacedContext, payload) { ... } // -> 'someAction'
         }
       }
     }
   }
 }

带命名空间的绑定函数

当使用 mapState、mapGetters、mapActions 和 mapMutations 这些函数来绑定带命名空间的模块时，写起来可能比较繁琐：

 computed: {
   ...mapState({
     a: state => state.some.nested.module.a,
     b: state => state.some.nested.module.b
   }),
   ...mapGetters([
     'some/nested/module/someGetter', // -> this['some/nested/module/someGetter']
     'some/nested/module/someOtherGetter', // -> this['some/nested/module/someOtherGetter']
   ])
 },
 methods: {
   ...mapActions([
     'some/nested/module/foo', // -> this['some/nested/module/foo']()
     'some/nested/module/bar' // -> this['some/nested/module/bar']()
   ])
 }

对于这种情况，你可以将模块的空间名称字符串作为第一个参数传递给上述函数，这样所有绑定都会自动将该模块作为上下文。于是上面的例子可以简化为：

 computed: {
   ...mapState('some/nested/module', {
     a: state => state.a,
     b: state => state.b
   }),
   ...mapGetters('some/nested/module', [
     'someGetter', // -> this.someGetter
     'someOtherGetter', // -> this.someOtherGetter
   ])
 },
 methods: {
   ...mapActions('some/nested/module', [
     'foo', // -> this.foo()
     'bar' // -> this.bar()
   ])
 }

而且，你可以通过使用 createNamespacedHelpers 创建基于某个命名空间辅助函数。它返回一个对象，对象里有新的绑定在给定命名空间值上的组件绑定辅助函数：

 import { createNamespacedHelpers } from 'vuex'
 ​
 const { mapState, mapActions } = createNamespacedHelpers('some/nested/module')
 ​
 export default {
   computed: {
     // 在 `some/nested/module` 中查找
     ...mapState({
       a: state => state.a,
       b: state => state.b
     })
   },
   methods: {
     // 在 `some/nested/module` 中查找
     ...mapActions([
       'foo',
       'bar'
     ])
   }
 }

给插件开发者的注意事项

如果你开发的插件提供了模块并允许用户将其添加到 Vuex store，可能需要考虑模块的空间名称问题。对于这种情况，你可以通过插件的参数对象来允许用户指定空间名称：

 // 通过插件的参数对象得到空间名称
 // 然后返回 Vuex 插件函数
 export function createPlugin (options = {}) {
   return function (store) {
     // 把空间名字添加到插件模块的类型（type）中去
     const namespace = options.namespace || ''
     store.dispatch(namespace + 'pluginAction')
   }
 }

模块动态注册

在 store 创建之后，你可以使用 store.registerModule 方法注册模块：

 import { createStore } from 'vuex'
 ​
 const store = createStore({ /* 选项 */ })
 ​
 // 注册模块 `myModule`
 store.registerModule('myModule', {
   // ...
 })
 ​
 // 注册嵌套模块 `nested/myModule`
 store.registerModule(['nested', 'myModule'], {
   // ...
 })

之后就可以通过 store.state.myModule 和 store.state.nested.myModule 访问模块的状态。

模块动态注册功能使得其他 Vue 插件可以通过在 store 中附加新模块的方式来使用 Vuex 管理状态。例如，vuex-router-sync 插件就是通过动态注册模块将 Vue Router 和 Vuex 结合在一起，实现应用的路由状态管理。

你也可以使用 store.unregisterModule(moduleName) 来动态卸载模块。注意，你不能使用此方法卸载静态模块（即创建 store 时声明的模块）。

注意，你可以通过 store.hasModule(moduleName) 方法检查该模块是否已经被注册到 store。需要记住的是，嵌套模块应该以数组形式传递给 registerModule 和 hasModule，而不是以路径字符串的形式传递给 module。

保留 state

在注册一个新 module 时，你很有可能想保留过去的 state，例如从一个服务端渲染的应用保留 state。你可以通过 preserveState 选项将其归档：store.registerModule('a', module, { preserveState: true })。

当你设置 preserveState: true 时，该模块会被注册，action、mutation 和 getter 会被添加到 store 中，但是 state 不会。这里假设 store 的 state 已经包含了这个 module 的 state 并且你不希望将其覆写。

模块重用

有时我们可能需要创建一个模块的多个实例，例如：

• 创建多个 store，他们公用同一个模块 (例如当 runInNewContext 选项是 false 或 'once' 时，为了在服务端渲染中避免有状态的单例)

• 在一个 store 中多次注册同一个模块

如果我们使用一个纯对象来声明模块的状态，那么这个状态对象会通过引用被共享，导致状态对象被修改时 store 或模块间数据互相污染的问题。

实际上这和 Vue 组件内的 data 是同样的问题。因此解决办法也是相同的——使用一个函数来声明模块状态（仅 2.3.0+ 支持）：

 const MyReusableModule = {
   state: () => ({
     foo: 'bar'
   }),
   // mutation、action 和 getter 等等...
 }

mapXXX

vuex中提供的mapxxx机制：

记住它仅仅只是一种就简化获取state和执行mutations和actions行为的方式，不用显示的区通过commit和dispatch去触发。他的思想就是借助：es6的对象解构。mapXXX就是一个对象。

 <template>
 <div>
   id:{{user.nickName}}
 </div>
 </template>
 ​
 <script>
 import { mapState } from 'vuex'
 ​
 export default {
   name: 'Login',
   props: {
     msg: String
   },
   // // 1.原生的写法
   //  computed: {
   //   user(){
   //     return this.$store.state.user;
   //   }
   // },
   // 2、用对象获取state数据，好处是可以随便更改名字
   //   computed:mapState({
   //   // key= count就是computed的计算属性，value="count"是vuex中state的属性key
   //   count:"count",
   //   user:"user"
   // }),
 ​
   // // 3：用数组的方式获取state的数据
   // computed:mapState(['count','user'])
 ​
   // 4:解构mapstate,为什么需要他？因为在实际的开发中，除了有vuex状态需要响应的属性之外还有
   // 我们页面当前页面需要控制的计算属性，所以使用解构来完成更好！
   computed:{
     ...mapState({
       user:'user'
     })
   }
 ​
 }
 </script>
 ​

在这里我们会遇到一个问题，那就是如何进行传参呢？

 <template>
   <div class="home">
     <img alt="Vue logo" src="../assets/logo.png">
     <HelloWorld msg="Welcome to Your Vue.js App"/>
     <Login></Login>
     当前的数量为：{{count}}
     <button @click="addcount">按钮</button>
     <button @click="toLogin">登录</button>
     <button @click="Login({nickName:'admin',password:'123456'})">登录</button>
 ​
 ​
   </div>
 </template>
 ​
 <script>
 // @ is an alias to /src
 import HelloWorld from '@/components/HelloWorld.vue'
 import Login from '@/components/Login.vue'
 import { mapActions } from 'vuex'
 ​
 export default {
   name: 'HomeView',
   components: {
     HelloWorld,
     Login
   },
   // computed:{
   //   count(){
   //     return this.$store.state.count
   //   },
   //   user(){
   //     return this.$store.state.user
   //   }
   // },
 ​
 ​
 ​
   // 事件定义的位置
   methods:{
     // 1. 定义count累加，改变vuex的状态！
     // addcount(){
     //   // this.$store.commit("increment")
     //   var nickName = "admin";
     //   var password = "123456";
 ​
     //   this.$store.dispatch('login', {nickName,password})
     // }
 ​
 ​
     // 1.用对象的方式解构actions的函数
     ...mapActions({login:'login'}),
     toLogin(){
       var nickName = "vuex admin"
       var password = "vuex 123456"
       this.login({nickName,password})
     }
   }
 }
 </script>

这里我们方式一：就是在输入框中进行赋值，可以定义在data中，也可以显示定义！

还有一种就是我们所推荐的：再次定义一个方法，进行获取！