1. 核心定位
Pinia 是 Vuex 的现代化替代方案，Vue3 官方首选；Vuex 是 Vue2 主流状态管理库。
2. 核心概念与执行流程
Vuex
-
组成：
state(数据)、getters(计算属性)、mutations(同步修改)、actions(异步逻辑)、modules(模块) -
流程：组件 →
dispatch(action)→commit(mutation)→ 修改state -
强制要求：数据修改必须走 mutation，mutation 仅支持同步代码
Pinia
-
组成：
state、getters、actions（移除 mutation） -
流程：组件 → 直接调用
action/ 直接修改state -
特点：
actions支持同步 + 异步，逻辑更集中，代码更简洁
3. 模块化
-
Vuex：单根 Store，通过嵌套
modules拆分，需手动开启namespaced防命名冲突，层级复杂易混乱。 -
Pinia：扁平化独立 Store，每个仓库相互独立，自带命名空间，无需额外配置，天然支持模块化。
4. TypeScript 支持
-
Vuex：后期兼容 TS，类型推断弱，写法繁琐。
-
Pinia：原生基于 TS 设计，自动类型推断，类型提示完善。
5. 其他差异
-
体积：Pinia（约 1KB）比 Vuex（约 2KB）更轻量。
-
调试：两者均支持 Vue DevTools，Pinia 调试体验更流畅。
-
适用场景：
-
Vuex：维护 Vue2 老项目、团队强规范场景。
-
Pinia：Vue3 所有新项目、组合式 API + TS 技术栈。
-
速记表
|---------|-----------------------------------------|-----------------------|
| 特性 | Vuex | Pinia |
| 核心模块 | state/getters/mutations/actions/modules | state/getters/actions |
| 同步 / 异步 | 异步放 actions，修改走 mutation | actions 可同步可异步 |
| 模块化 | 嵌套模块，需命名空间 | 独立扁平化 Store，自带命名空间 |
| TS 支持 | 一般 | 原生友好 |
| 推荐场景 | Vue2 老项目 | Vue3 新项目 |