Become a sponsor
9.6 状态管理（Pinia）
概述
全局状态集中在 7 个 Pinia 模块：用户身份、动态路由、标签页、设计设置、项目设置、锁屏、OSS 配置。页面局部状态不进 store。
Store 清单
| 模块 | 职责 | 持久化 |
|---|---|---|
| user | token、用户信息、权限集合 | token 经 storage 持久化 |
| asyncRoute | 菜单树、动态路由表、是否已注入标记 | — |
| tabsView | 标签页导航（多页签状态） | 经 storage |
| designSetting | 主题配色、布局尺寸、组件大小 | 经 storage |
| projectSetting | 项目级开关（水印、锁屏、面包屑等） | 经 storage |
| lockscreen | 锁屏状态 | 经 storage |
| ossConfig | 对象存储配置（直传场景） | — |
mutation-types 与 storage
store/mutation-types.ts 定义 storage 键名常量（ACCESS_TOKEN、FIRST_ROUTE 等），utils/Storage 提供统一持久化读写——不散落裸字符串键。
使用规约
| 规约 | 说明 |
|---|---|
| 跨页面才进 store | 表单草稿等页面内状态用 ref |
| 组合式风格 | useUserStore() 调用式获取，避免 Pinia 旧式选项冗余 |
| 宽访问出口 | useUserStoreWidthOut() 供守卫等场景（脱离组件上下文） |
| 权限只读 | 权限集合由 GetInfo 写入，业务只读判定 |
与后端的数据流
text
登录 → token 写 storage + user store
路由守卫 → GetInfo 填 user store（含权限集合）→ generateRoutes 填 asyncRoute store
登出/401 → 清 token 与相关 store → 跳登录