vue过滤器在微信小程序端默认不生效,因wxml不支持运行时过滤器解析且无法访问vue实例的filters配置,需改用wxs或显式函数调用。

uni-app 的 Vue 过滤器(v-model 之外的 {{ value | filterName }})在微信小程序端**默认不生效**——编译后会被直接忽略,既不报错也不执行。这不是 bug,而是 uni-app 编译机制决定的:WXML 不支持运行时过滤器解析,且小程序视图层无法访问 Vue 实例的 filters 配置。
为什么 Vue 过滤器在微信小程序里失效
Vue 过滤器依赖 Vue runtime 的模板编译与执行逻辑,而 uni-app 编译到微信小程序时,会把 .vue 模板转成静态 WXML + JS 逻辑分离结构。WXML 中的 {{ }} 表达式只做简单求值,不走 Vue 的 filter 管道链。即使你在 main.js 里用 Vue.filter 注册了,小程序端也完全无感知。
- 现象:
{{ timestamp | formatDate }}在 H5 正常显示,在微信小程序里原样输出timestamp值或报ReferenceError: formatDate is not defined - 注意:uni-app 3.x(Vue 3)已移除全局
Vue.filterAPI,连注册入口都没了 - 替代方案必须是「显式调用函数」或「WXS 处理」,不能依赖模板语法糖
用 WXS 实现轻量格式化(仅限微信小程序)
WXS 是微信小程序原生支持的视图层脚本,适合做纯计算、无副作用的数据转换,比如时间戳转“刚刚”、金额千分位、状态码转文案。它在 WXML 渲染时同步执行,性能比 JS 层处理更优。
解析微信公众号文章,提取标题、作者、正文、图片等信息。用户发送链接(mp.weixin.qq.com)时触发,自动提取内容并可保存至飞书表格。
- 新建
static/wxs/filters.wxs,内容必须用 CommonJS 导出:module.exports = { formatTime: function(timestamp) { if (!timestamp || typeof timestamp !== 'number') return '' const diff = Date.now() - timestamp if (diff - 在 WXML 顶部引入:
wxs:filters="require('../static/wxs/filters.wxs')"(路径必须相对,不能用@/别名) - 调用写法:
{{ filters.formatTime(item.time) }},不是{{ item.time | formatTime }} - ⚠️ 限制:WXS 不支持
?. ??、解构、console,也不能访问this或页面 data 以外的数据
跨平台兼容写法:封装工具函数 + 条件编译
如果需要同时支持 H5、App、微信小程序等多端,不能只靠 WXS。最稳妥的方式是统一用 JS 工具函数,并用条件编译隔离平台差异:
- 创建
utils/filters.js,导出纯函数:export function formatDate(timestamp, format = 'yyyy-MM-dd hh:mm:ss') { // 实现逻辑... return formatted } - 在页面中按需调用:
<template><view>{{ formatDate(item.time) }}</view></template><script> import { formatDate } from '@/utils/filters' export default { methods: { formatDate } } </script> - 关键点:H5 和 App 走 Vue 运行时,可复用同一套函数;微信小程序因 WXML 不支持方法调用,需在
data或computed中预处理:computed: { formattedTime() { // #ifdef MP-WEIXIN return this.$filters.formatDate(this.item.time) // #endif // #ifndef MP-WEIXIN return formatDate(this.item.time) // #endif } }
容易被忽略的细节
WXS 文件路径写错、忘记在 WXML 里声明 wxs: 别名、在 H5 端误用 WXS 调用方式、或者把需要响应式更新的逻辑塞进 WXS —— 这些都会导致白屏或静默失败。真正要解决的不是“怎么让过滤器跑起来”,而是“哪些逻辑必须在视图层做、哪些必须提前算好”。WXS 只能处理确定性输入,JS 工具函数才能配合响应式系统。跨端项目里,优先保证功能可用,再考虑视图层性能优化。










