Vue.filter 必须全局注册且仅 Vue 2 生效；状态码映射需字符串键兜底防 undefined 渲染异常；过滤器须在 new Vue 前注册于 main.js；组件内 filters/methods/computed 均不被模板 | 语法识别；映射表应抽离为独立配置，避免硬编码导致维护成本上升。
必须全局注册 Vue.filter，且只在 Vue 2 模式下生效；状态码映射要字符串键兜底，否则 undefined 会直接导致渲染空白或报错。
过滤器必须在 main.js 里注册，不能写在组件里
模板中写 {{ status | statusText }}，但这个语法只认全局注册的过滤器。组件内部的 filters 选项、methods 里的函数、甚至 computed 都不会被 | 识别。
-
Vue.filter('statusText', ...)必须出现在new Vue({})之前，否则已编译的模板无法关联到它 - 如果项目用了 HBuilderX 或 vue-cli 创建，默认是 Vue 2 模式（
@dcloudio/uni-app版本 Vue.filter 有效；若已升级到 uni-app 3（Vue 3），该 API 已被移除，|不再解析 - 别在
onLoad、created等生命周期里注册——太晚，模板早已完成编译
statusText 过滤器要防空、防类型不匹配
后端返回的状态码可能是数字、字符串，也可能为 null、undefined 或空字符串，直接查表会返回 undefined，最终渲染为空白。
- 键必须用字符串，比如
'0'而不是0，因为 JSON 解析后字段值常为字符串类型 - 必须有兜底：返回
map[value] || '未知状态'，不能只写map[value] - 不要在过滤器里调用
this.$t做 i18n，上下文不可靠；如需多语言，应提前把字典注入全局或传入纯函数处理
模板里用错路径或初始值会静默失败
{{ status | statusText }} 看似简单，但实际出问题最多的是数据来源不对或未初始化。
-
status必须是顶层data属性，或明确声明在data() { return { item: {} } }中，那就要写{{ item.status | statusText }} -
v-for="item in list"时，若list初始为undefined或null，会触发Cannot read property 'status' of undefined - 嵌套过深如
{{ item.info.status | statusText }}，一旦item.info为undefined就崩；应改用{{ (item.info?.status) | statusText }}（需确保基础库支持可选链）
小程序端不执行过滤器，别依赖它做关键逻辑
微信、支付宝、字节等小程序平台的编译器跳过 | 解析，Vue.filter 注册了也无效。H5 可能正常，但真机一跑就回退成原始数字。
- 这不是 bug，是平台限制：小程序运行时不加载 Vue 的过滤器管道逻辑
- 真正跨端稳定的方案是把映射逻辑提前——在
onLoad请求后立刻转换：this.list = res.data.map(i => ({ ...i, statusText: map[i.status] || '未知状态' })) - 或者封装成工具函数，在
setup或methods中手动调用，避免模板层依赖
最易忽略的点：状态码字段名可能随接口版本变化，硬编码在过滤器里会让后续维护成本陡增；建议把映射表抽成独立 JSON 或配置对象，和业务逻辑解耦。
