Vue状态管理之vuex|原理篇

文章学习导航

面试总览

30 秒速记

核心判断：状态管理的核心是把状态变化约束成可追踪的数据流，中间件在派发边界扩展异步、日志和副作用
原理主线：围绕「一、初始vuex」、「二、modules」、「三、mutations」建立输入、状态变化与输出之间的因果关系
文章范围：介绍了Vuex的核心概念、原理及其在Vue项目中的状态管理应用，涵盖state、getters、mutations、actions和modules等模块，帮助开发者理解和高效使用Vuex进行全局状态管理。
边界与代价：集中式状态不是越多越好；可变性、订阅粒度和异步取消决定性能与可维护性
工程落地：选型要从状态归属、更新频率、调试需求和团队约束出发，而不是只比较 API 数量

Vuex 本质上是把多个组件共享的状态集中管理，并规定统一的数据读取和修改路径。 状态放在 state，公共派生数据交给 getters，同步修改通过 mutations，异步流程或多个修改则由 actions 调度。组件可用 mapState、mapGetters 和 mapActions 减少重复代码，状态较多时再用 modules 拆分。小型应用不必过度分模块，但应避免组件绕过 commit 随意修改共享状态。

这篇文章不要按 API 清单来背。先用上面的 Mind Map 建立全局结构，再通过交互 DEMO 观察正常路径和边界路径如何改变状态；阅读正文时重点核对每一步的输入、负责执行的参与者、产生的中间状态以及最终可观察结果。遇到版本敏感结论，要把“历史实现”“当前行为”和“工程兼容策略”分开说明；遇到性能或架构取舍，则用实际指标、失败现象和验证手段支撑判断。

版本校准： 本文出现 Object.defineProperty、Dep、Watcher 和双端 Diff 时，主要描述 Vue 2 实现；Vue 3 使用 Proxy、effect 与新的渲染器路径。Vue 2 已于 2023-12-31 结束维护，新项目应以 Vue 3 为基线，旧项目参考 Vue 2 EOL 官方说明制定迁移与安全策略。

了解vuex核心概念请移步 https://vuex.vuejs.org/zh/

# 一、初始vuex

# 1.1 vuex是什么

vuex
@前端进阶之旅: 代码已经复制到剪贴板
就是把需要共享的变量全部存储在一个对象里面，然后将这个对象放在顶层组件中供其他组件使用

父子组件通信时，我们通常会采用 props + emit 这种方式。但当通信双方不是父子组件甚至压根不存在相关联系，或者一个状态需要共享给多个组件时，就会非常麻烦，数据也会相当难维护

# 1.2 vuex中有什么

const store = new Vuex.Store({
    state: {
        name: 'weish',
        age: 22
    },
    getters: {
        personInfo(state) {
            return `My name is ${state.name}, I am ${state.age}`;
        }
    }
    mutations: {
        SET_AGE(state, age) {
            commit(age, age);
        }
    },
    actions: {
        nameAsyn({commit}) {
            setTimeout(() => {
                commit('SET_AGE', 18);
            }, 1000);
        }
    },
    modules: {
        a: modulesA
    }
}

@前端进阶之旅: 代码已经复制到剪贴板

个就是最基本也是完整的vuex代码；vuex 包含有五个基本的对象

state：存储状态。也就是变量；
getters：派生状态。也就是set、get中的get，有两个可选参数：state、getters分别可以获取state中的变量和其他的getters。外部调用方式：store.getters.personInfo()。就和vue的computed差不多；
mutations：提交状态修改。也就是set、get中的set，这是vuex中唯一修改state的方式，但不支持异步操作。第一个参数默认是state。外部调用方式：store.commit('SET_AGE', 18)。和vue中的methods类似。
actions：和mutations类似。不过actions支持异步操作。第一个参数默认是和store具有相同参数属性的对象。外部调用方式：store.dispatch('nameAsyn')。
modules：store的子模块，内容就相当于是store的一个实例。调用方式和前面介绍的相似，只是要加上当前子模块名，如：store.a.getters.xxx()

# 1.3 vue-cli中使用vuex的方式

目录结构

├── index.html
├── main.js
├── components
└── store
    ├── index.js          # 我们组装模块并导出 store 的地方
    ├── state.js          # 跟级别的 state
    ├── getters.js        # 跟级别的 getter
    ├── mutation-types.js # 根级别的mutations名称（官方推荐mutions方法名使用大写）
    ├── mutations.js      # 根级别的 mutation
    ├── actions.js        # 根级别的 action
    └── modules
        ├── m1.js         # 模块1
        └── m2.js         # 模块2

@前端进阶之旅: 代码已经复制到剪贴板

state示例

const state = {
    name: 'weish',
    age: 22
};

export default state;

@前端进阶之旅: 代码已经复制到剪贴板

getter示例

getters.js示例（我们一般使用getters来获取state的状态，而不是直接使用state）

export const name = (state) => {
    return state.name;
}

export const age = (state) => {
    return state.age
}

export const other = (state) => {
    return `My name is ${state.name}, I am ${state.age}.`;
}

@前端进阶之旅: 代码已经复制到剪贴板

mutation-type示例

将所有mutations的函数名放在这个文件里

export const SET_NAME = 'SET_NAME';
export const SET_AGE = 'SET_AGE';

@前端进阶之旅: 代码已经复制到剪贴板

mutations示例

import * as types from './mutation-type.js';

export default {
    [types.SET_NAME](state, name) {
        state.name = name;
    },
    [types.SET_AGE](state, age) {
        state.age = age;
    }
};

@前端进阶之旅: 代码已经复制到剪贴板

actions示例

异步操作、多个commit时

import * as types from './mutation-type.js';

export default {
    nameAsyn({commit}, {age, name}) {
        commit(types.SET_NAME, name);
        commit(types.SET_AGE, age);
    }
}

@前端进阶之旅: 代码已经复制到剪贴板

modules–m1.js示例

如果不是很复杂的应用，一般来讲是不会分模块的

export default {
    state: {},
    getters: {},
    mutations: {},
    actions: {}
}

@前端进阶之旅: 代码已经复制到剪贴板

index.js示例（组装vuex)

import vue from 'vue';
import vuex from 'vuex';
import state from './state.js';
import * as getters from './getters.js';
import mutations from './mutations.js';
import actions from './actions.js';
import m1 from './modules/m1.js';
import m2 from './modules/m2.js';
import createLogger from 'vuex/dist/logger'; // 修改日志

vue.use(vuex);

const debug = process.env.NODE_ENV !== 'production'; // 开发环境中为true，否则为false

export default new vuex.Store({
    state,
    getters,
    mutations,
    actions,
    modules: {
        m1,
        m2
    },
    plugins: debug ? [createLogger()] : [] // 开发环境下显示vuex的状态修改
});

@前端进阶之旅: 代码已经复制到剪贴板

最后将store实例挂载到main.js里面的vue上去就行了

import store from './store/index.js';

new Vue({
  el: '#app',
  store,
  render: h => h(App)
});

@前端进阶之旅: 代码已经复制到剪贴板

在vue组件中使用时，我们通常会使用mapGetters、mapActions、mapMutations，然后就可以按照vue调用methods和computed的方式去调用这些变量或函数，示例如

import {mapGetters, mapMutations, mapActions} from 'vuex';

/* 只写组件中的script部分 */
export default {
    computed: {
        ...mapGetters([
            name,
            age
        ])
    },
    methods: {
        ...mapMutations({
            setName: 'SET_NAME',
            setAge: 'SET_AGE'
        }),
        ...mapActions([
            nameAsyn
        ])
    }
};

@前端进阶之旅: 代码已经复制到剪贴板

# 二、modules

在 src 目录下 , 新建一个 store 文件夹 , 然后在里面新建一个 index.js

import Vue from 'vue'
import vuex from 'vuex'
Vue.use(vuex);

export default new vuex.Store({
    state:{
        show:false
    }
})

@前端进阶之旅: 代码已经复制到剪贴板

在 main.js 里的代码应该改成,在实例化 Vue对象时加入 store 对象

//vuex
import store from './store'

new Vue({
  el: '#app',
  router,
  store,//使用store
  template: '<App/>',
  components: { App }
})

@前端进阶之旅: 代码已经复制到剪贴板

这样就把 store 分离出去了 , 那么还有一个问题是 : 这里 $store.state.show 无论哪个组件都可以使用 , 那组件多了之后 , 状态也多了 , 这么多状态都堆在 store 文件夹下的 index.js 不好维护怎么办 ?

我们可以使用 vuex 的 modules , 把 store 文件夹下的 index.js 改成

文章学习导航

面试总览

30 秒速记

核心判断：状态管理的核心是把状态变化约束成可追踪的数据流，中间件在派发边界扩展异步、日志和副作用
原理主线：围绕「一、初始vuex」、「二、modules」、「三、mutations」建立输入、状态变化与输出之间的因果关系
文章范围：介绍了Vuex的核心概念、原理及其在Vue项目中的状态管理应用，涵盖state、getters、mutations、actions和modules等模块，帮助开发者理解和高效使用Vuex进行全局状态管理。
边界与代价：集中式状态不是越多越好；可变性、订阅粒度和异步取消决定性能与可维护性
工程落地：选型要从状态归属、更新频率、调试需求和团队约束出发，而不是只比较 API 数量

了解vuex核心概念请移步 https://vuex.vuejs.org/zh/

# 一、初始vuex

# 1.1 vuex是什么

vuex
@前端进阶之旅: 代码已经复制到剪贴板
就是把需要共享的变量全部存储在一个对象里面，然后将这个对象放在顶层组件中供其他组件使用

父子组件通信时，我们通常会采用 props + emit 这种方式。但当通信双方不是父子组件甚至压根不存在相关联系，或者一个状态需要共享给多个组件时，就会非常麻烦，数据也会相当难维护

# 1.2 vuex中有什么

const store = new Vuex.Store({
    state: {
        name: 'weish',
        age: 22
    },
    getters: {
        personInfo(state) {
            return `My name is ${state.name}, I am ${state.age}`;
        }
    }
    mutations: {
        SET_AGE(state, age) {
            commit(age, age);
        }
    },
    actions: {
        nameAsyn({commit}) {
            setTimeout(() => {
                commit('SET_AGE', 18);
            }, 1000);
        }
    },
    modules: {
        a: modulesA
    }
}

@前端进阶之旅: 代码已经复制到剪贴板

个就是最基本也是完整的vuex代码；vuex 包含有五个基本的对象

state：存储状态。也就是变量；
getters：派生状态。也就是set、get中的get，有两个可选参数：state、getters分别可以获取state中的变量和其他的getters。外部调用方式：store.getters.personInfo()。就和vue的computed差不多；
mutations：提交状态修改。也就是set、get中的set，这是vuex中唯一修改state的方式，但不支持异步操作。第一个参数默认是state。外部调用方式：store.commit('SET_AGE', 18)。和vue中的methods类似。
actions：和mutations类似。不过actions支持异步操作。第一个参数默认是和store具有相同参数属性的对象。外部调用方式：store.dispatch('nameAsyn')。
modules：store的子模块，内容就相当于是store的一个实例。调用方式和前面介绍的相似，只是要加上当前子模块名，如：store.a.getters.xxx()

# 1.3 vue-cli中使用vuex的方式

目录结构

├── index.html
├── main.js
├── components
└── store
    ├── index.js          # 我们组装模块并导出 store 的地方
    ├── state.js          # 跟级别的 state
    ├── getters.js        # 跟级别的 getter
    ├── mutation-types.js # 根级别的mutations名称（官方推荐mutions方法名使用大写）
    ├── mutations.js      # 根级别的 mutation
    ├── actions.js        # 根级别的 action
    └── modules
        ├── m1.js         # 模块1
        └── m2.js         # 模块2

@前端进阶之旅: 代码已经复制到剪贴板

state示例

const state = {
    name: 'weish',
    age: 22
};

export default state;

@前端进阶之旅: 代码已经复制到剪贴板

getter示例

getters.js示例（我们一般使用getters来获取state的状态，而不是直接使用state）

export const name = (state) => {
    return state.name;
}

export const age = (state) => {
    return state.age
}

export const other = (state) => {
    return `My name is ${state.name}, I am ${state.age}.`;
}

@前端进阶之旅: 代码已经复制到剪贴板

mutation-type示例

将所有mutations的函数名放在这个文件里

export const SET_NAME = 'SET_NAME';
export const SET_AGE = 'SET_AGE';

@前端进阶之旅: 代码已经复制到剪贴板

mutations示例

import * as types from './mutation-type.js';

export default {
    [types.SET_NAME](state, name) {
        state.name = name;
    },
    [types.SET_AGE](state, age) {
        state.age = age;
    }
};

@前端进阶之旅: 代码已经复制到剪贴板

actions示例

异步操作、多个commit时

import * as types from './mutation-type.js';

export default {
    nameAsyn({commit}, {age, name}) {
        commit(types.SET_NAME, name);
        commit(types.SET_AGE, age);
    }
}

@前端进阶之旅: 代码已经复制到剪贴板

modules–m1.js示例

如果不是很复杂的应用，一般来讲是不会分模块的

export default {
    state: {},
    getters: {},
    mutations: {},
    actions: {}
}

@前端进阶之旅: 代码已经复制到剪贴板

index.js示例（组装vuex)

import vue from 'vue';
import vuex from 'vuex';
import state from './state.js';
import * as getters from './getters.js';
import mutations from './mutations.js';
import actions from './actions.js';
import m1 from './modules/m1.js';
import m2 from './modules/m2.js';
import createLogger from 'vuex/dist/logger'; // 修改日志

vue.use(vuex);

const debug = process.env.NODE_ENV !== 'production'; // 开发环境中为true，否则为false

export default new vuex.Store({
    state,
    getters,
    mutations,
    actions,
    modules: {
        m1,
        m2
    },
    plugins: debug ? [createLogger()] : [] // 开发环境下显示vuex的状态修改
});

@前端进阶之旅: 代码已经复制到剪贴板

最后将store实例挂载到main.js里面的vue上去就行了

import store from './store/index.js';

new Vue({
  el: '#app',
  store,
  render: h => h(App)
});

@前端进阶之旅: 代码已经复制到剪贴板

在vue组件中使用时，我们通常会使用mapGetters、mapActions、mapMutations，然后就可以按照vue调用methods和computed的方式去调用这些变量或函数，示例如

import {mapGetters, mapMutations, mapActions} from 'vuex';

/* 只写组件中的script部分 */
export default {
    computed: {
        ...mapGetters([
            name,
            age
        ])
    },
    methods: {
        ...mapMutations({
            setName: 'SET_NAME',
            setAge: 'SET_AGE'
        }),
        ...mapActions([
            nameAsyn
        ])
    }
};

@前端进阶之旅: 代码已经复制到剪贴板

# 二、modules

在 src 目录下 , 新建一个 store 文件夹 , 然后在里面新建一个 index.js

import Vue from 'vue'
import vuex from 'vuex'
Vue.use(vuex);

export default new vuex.Store({
    state:{
        show:false
    }
})

@前端进阶之旅: 代码已经复制到剪贴板

在 main.js 里的代码应该改成,在实例化 Vue对象时加入 store 对象

//vuex
import store from './store'

new Vue({
  el: '#app',
  router,
  store,//使用store
  template: '<App/>',
  components: { App }
})

@前端进阶之旅: 代码已经复制到剪贴板

这样就把 store 分离出去了 , 那么还有一个问题是 : 这里 $store.state.show 无论哪个组件都可以使用 , 那组件多了之后 , 状态也多了 , 这么多状态都堆在 store 文件夹下的 index.js 不好维护怎么办 ?

我们可以使用 vuex 的 modules , 把 store 文件夹下的 index.js 改成