uni-app 3.x 已废弃 filter,模板中 {{ value | defaultnull }} 失效;因 vue 3 不支持全局过滤器,且小程序平台编译时忽略或报错,需改用 computed 或方法封装默认值逻辑。

uni-app 里没有全局过滤器机制,所谓“统一处理 null”必须靠数据层拦截或 computed 封装,不能依赖模板 filter(uni-app 3.x 已废弃 filter)。
为什么 template 中写 {{ value | defaultNull }} 会失效
uni-app 3.x 版本已移除 filters 配置项,Vue 3 的 composition API 也不支持全局 filter 注册;即使 Vue 2 项目里声明了 filters,H5 端可能生效,但微信/支付宝小程序和 App 端编译时直接忽略或报错 filter is not defined。
- 模板语法不支持运行时函数调用,
{{ value?.name || '–' }}这种链式判断在某些小程序平台会被编译成无效表达式 - 后端返回的
null或undefined在绑定到v-model或props时,可能触发组件内部类型校验失败(比如uni-data-select要求options是数组,传入null就渲染空白) - 直接在模板里写三元表达式易重复、难维护,比如
{{ item.author?.name ?? '匿名' }}出现在 10 个地方,改文案就得找遍所有 .vue 文件
推荐方案:用 computed 或方法封装默认值逻辑
把字段映射和兜底逻辑收口到单点,既可复用,又避免模板污染。
- 对单个字段:用
computed包一层,例如formattedTitle() { return this.rawData?.title ?? '无标题' } - 对整条数据对象:写一个通用转换方法,如
normalizeItem(item) { return { title: item.title ?? '', desc: item.desc ?? '', avatar: item.avatar || '/static/default-avatar.png' } },在onLoad或watch里调用 - 若接口返回结构固定(如所有列表接口都带
author、cover、publish_time),建议在 request 层统一处理,例如 axios 响应拦截器中做data = deepReplaceNull(data, '') - 别用
JSON.parse(JSON.stringify(obj))清洗 null——它会丢掉 Date、RegExp、undefined 等类型,且对循环引用直接报错
容易踩的坑:null 和空字符串混用场景
后端常把「未填写」返回 null,而「填了空格」返回 "",两者语义不同,但 UI 层往往要统一展示为“–”或占位图。
-
??(空值合并)只判null和undefined,对''、0、false不生效;需要模糊兜底时改用||,但注意0也会被替换 - 金额字段慎用
|| '0.00',否则price: 0会变成字符串'0.00',后续计算出错 - 图片地址字段建议组合判断:
item.cover || item.default_cover || '/static/placeholder.jpg',而不是只看是否为null - 数组字段如
tags: null,应转成[]再遍历,否则v-for报错,不能只靠v-if="tags?.length"
最常被忽略的是后端字段命名不一致:同一业务字段在不同接口里可能是 user_name、userName、nickName,导致你写的 normalizeUser 方法漏处理。建议在接口文档阶段就推动后端收敛字段名,比前端补 N 个 ?? 更可靠。









