Vue / 系统课时
设计状态模块
设计状态模块
管理后台中的状态如果全部放进一个 Store,很快会出现字段混杂、调用链不清和维护困难。本课将先判断哪些数据值得进入全局状态,再按用户、应用和业务职责拆分 Pinia Store,形成可扩展的状态边界。
学习目标
- 判断组件局部状态、跨页面状态和服务端数据各自应该放在哪里
- 按用户、应用和业务职责规划 Pinia Store
- 用清晰的命名与依赖规则避免 Store 互相耦合
先判断数据是否需要全局共享
全局状态适合保存“多个页面都需要、切换路由后仍应保留、由多个组件共同修改”的数据,例如当前用户、侧边栏折叠状态、主题偏好和跨页面筛选条件。只在单个弹窗、表单或页面内部使用的数据,应优先留在组件中。
接口返回的数据也不应默认全部复制到 Pinia。列表、详情等服务端数据通常由页面按需请求;只有确实需要跨页面复用、需要持久化,或需要集中控制刷新时机的数据,才进入 Store。这样可以减少重复来源,避免页面数据与 Store 数据不一致。
按职责划分 Store
建议先划分三类模块:
- 用户状态:当前用户资料、角色、权限、登录后的初始化状态
- 应用状态:菜单折叠、主题、语言、页面布局等全局界面偏好
- 业务状态:只服务于某个业务域的跨页面数据,例如订单筛选条件或草稿

一个 Store 应围绕单一职责组织,字段、计算属性和动作都服务于同一个状态域。不要因为多个字段经常一起出现,就把用户、菜单、通知和订单全部塞进同一个 useGlobalStore。
建立目录与命名规则
在已经安装并注册 Pinia 的 Vue 3 项目中,可以先建立下面的模块骨架。该示例使用 Setup Store 写法,每个 Store 只暴露本模块需要的状态和动作。
// src/stores/modules/user.ts
import { defineStore } from 'pinia'
import { ref } from 'vue'
export const useUserStore = defineStore('user', () => {
const userId = ref<string | null>(null)
const roles = ref<string[]>([])
function reset() {
userId.value = null
roles.value = []
}
return { userId, roles, reset }
})
// src/stores/modules/app.ts
import { defineStore } from 'pinia'
import { ref } from 'vue'
export const useAppStore = defineStore('app', () => {
const sidebarCollapsed = ref(false)
function toggleSidebar() {
sidebarCollapsed.value = !sidebarCollapsed.value
}
return { sidebarCollapsed, toggleSidebar }
})预期结果
项目可以分别导入 useUserStore 和 useAppStore。
调用 userStore.reset() 只清理用户状态。
调用 appStore.toggleSidebar() 只改变侧边栏折叠状态。Store 的文件名、defineStore 标识和导出函数应保持同一语义,例如文件 user.ts 对应标识 user 和函数 useUserStore。这样在调试工具、报错日志和代码搜索中都能快速定位模块。
控制 Store 之间的依赖
页面可以同时使用多个 Store,但 Store 之间应尽量通过公开 action 协作,而不是直接改写对方的 state。若退出登录需要同时清理用户信息和业务草稿,可以由统一的退出流程依次调用两个 Store 的清理 action。
当两个 Store 频繁互相调用时,通常说明职责划分有问题。优先把共享规则抽成普通函数或服务模块;确实需要依赖时,保持单向关系,例如业务 Store 可以读取用户编号,但用户 Store 不反向依赖具体业务 Store。
设计完成后的检查
完成模块规划后,逐项确认:局部状态没有被无意义地提升为全局状态;每个 Store 只有一个清晰职责;服务端数据没有形成两个来源;跨 Store 调用保持单向;所有重置动作都有明确入口。
这一步先确定边界,再开始写具体状态。边界稳定后,后续增加权限、主题或业务模块时,只需扩展对应 Store,不必修改一个巨大的全局对象。