Vue 2 项目必须使用 Vuex 3.x，Vue 3 项目必须使用 Vuex 4.x，二者因响应式系统和 API 设计差异不兼容；新项目推荐优先选用官方推荐的 Pinia。
Vue 2 项目必须用 Vuex 3.x，Vue 3 项目必须用 Vuex 4.x——版本不兼容，不能混用。
Vue 2 对应 Vuex 3
Vuex 3 是专为 Vue 2 设计的，底层依赖 Vue 2 的响应式系统（Object.defineProperty）和插件机制。安装命令明确指定版本：
- npm install vuex@3 或 yarn add vuex@3
- 在 main.js 中需调用
Vue.use(Vuex)注册插件 - Store 实例用
new Vuex.Store({ ... })创建 - 组件内通过
this.$store访问，支持mapState、mapActions等辅助函数
Vue 3 对应 Vuex 4
Vuex 4 适配 Vue 3 的 Composition API 和 Proxy 响应式系统，不再需要 Vue.use()，也不再支持 Vue 2 的 Options API 风格写法（如 mutations 写成对象方法）。关键差异包括：
Vue Composition Analyzer
下载
分析 Vue 3 Composition API 使用情况——审计响应式模式、可组合函数设计、ref 与 reactive 的选择、计算属性、watcher 使用及组件……
-
npm install vuex@4（官方已弃用
@next，当前稳定版即 4.x） - Store 创建使用
createStore()函数，state 推荐写成返回对象的函数：state: () => ({ count: 0 }) - 在 main.js 中直接通过
app.use(store)挂载（基于 createApp） - Composition API 中推荐用
useStore()钩子获取 store，而非this.$store
别踩的坑：版本错配的典型表现
如果在 Vue 3 里装了 Vuex 3，或 Vue 2 里用了 Vuex 4，会出现以下错误：
立即学习“前端免费学习笔记（深入）”；
- “Cannot read property 'use' of undefined”（Vuex 3 在 Vue 3 下无法识别 createApp）
- “Uncaught TypeError: Cannot set property '$store' of undefined”（Vuex 4 在 Vue 2 下找不到 this 上下文）
- 辅助函数（如 mapState）失效，
$store在组件中为 undefined - TypeScript 类型推断失败，store 实例缺少泛型支持
补充建议：新项目优先考虑 Pinia
虽然 Vuex 4 支持 Vue 3，但官方已将 Pinia 定为 Vue 官方推荐的状态管理库（自 Vue 3.2 起）。相比 Vuex：
- Pinia 无需 mutations，action 可同步/异步混合，API 更简洁
- 天然支持 TypeScript，store 类型自动推导更准确
- 模块化是默认设计，无命名空间烦恼
- 开发体验更好：支持热更新、devtools 集成更顺滑
