pinia getters 实现状态码映射为中文描述的核心是封装响应式、可复用、不破坏缓存的「码→文」getter，推荐用对象查表法（如 statustext: (state) => status_text[state.code as keyof typeof status_text] ?? '未知状态'），避免 if-else、返回新对象、读取非响应式源或副作用操作。
Pinia Getters 实现状态码映射为中文描述，核心是把「码→文」的映射逻辑封装成响应式、可复用、不破坏缓存的 getter，而不是在组件里硬写 if-else 或 switch。
用对象字面量 + state 驱动映射
适合状态码固定、数量不多（如 0/1/2/1001/1002 等业务约定码）的场景。直接在 getter 中定义映射表，通过 state 中的 code 值查表返回中文：
- 定义方式：statusText: (state) => ({ 0: '待处理', 1: '已通过', 2: '已拒绝', 1001: '参数错误', 1002: '权限不足' })[state.code] ?? '未知状态'
- 优点：简洁、零依赖、完全响应式——只要
state.code变，statusText自动更新 - 注意：确保
state.code是响应式属性（即定义在state()函数内），否则 getter 不会重算
用计算函数封装，支持动态扩展与 fallback
当映射规则变复杂（比如需根据环境切换文案、或需拼接上下文），可把映射逻辑抽成独立函数，在 getter 中调用：
- 示例：statusText() { const map = this.statusMap; return map[this.code] ?? map.default ?? '状态未定义'; }，再配合
statusMap: () => ({ ... })或从外部导入常量对象 - 好处：便于单元测试、支持 i18n 切换、可统一处理空值/非法码等边界情况
- 关键点：getter 内部必须只读取响应式数据（如
this.code、this.statusMap），不能引入Date.now()等非响应式值，否则缓存失效
结合枚举或常量模块，提升类型安全与维护性
在 TypeScript 项目中，推荐将状态码定义为枚举或 const 对象，再让 getter 引用它：
- 例如定义
export const STATUS_TEXT = { 0: '初始化', 1: '运行中', -1: '已终止' } as const - getter 写成：statusText: (state) => STATUS_TEXT[state.code as keyof typeof STATUS_TEXT] ?? '未识别状态'
- 这样既享受自动补全和类型检查，又避免魔数散落各处，重构时一改全改
避免常见陷阱
以下写法会让映射失效或性能下降，需规避：
- 在 getter 里写
if (code === 0) return '待处理'; else if (code === 1) ...—— 冗长难维护，且无法利用对象查表的 O(1) 性能 - 返回新对象，如
() => ({ [code]: text })—— 每次返回不同引用，导致组件强制更新 - 从非响应式源读取映射表，比如
import { map } from './config'后直接用map[code]—— map 变化时 getter 不感知 - 在 getter 中发起请求或调用
new Date()—— 破坏纯函数特性，缓存机制瘫痪
