uni-app过滤器不支持多参数语法，仅允许{{ value | filterName }}形式；正确方式为对象传参或链式单参过滤器，推荐改用methods、computed或工具函数替代。
uni-app过滤器不支持多参数语法
Vue 2（uni-app 当前底层）的过滤器语法只允许 {{ value | filterName }} 这一种写法，{{ value | filterName('a', 'b') }} 是非法表达式，编译阶段就会报错 Invalid expression。这不是 uni-app 的限制，而是 Vue 2 模板编译器本身的硬性规则。
正确传多个值：只能靠对象参数或拆成单参链式
想让过滤器“接收多个上下文字段”，必须把它们打包成一个对象传进去，或者拆成多个单参数过滤器串联：
- ✅ 推荐方式一（对象传参）：
{{ item | formatItem({ type: item.type, id: item.id, status: item.status }) }}，对应过滤器签名是function(item, config) { ... } - ✅ 推荐方式二（链式拆分）：
{{ item | withType(item.type) | withStatus(item.status) }}，每个过滤器只处理一个维度，保持纯函数特性 - ❌ 错误写法：
{{ item | formatItem(item.type, item.status) }}—— 编译直接失败
局部 filters 中访问 v-for 当前行数据的真相
过滤器函数第一个参数就是管道前的值（比如 item），它本身就是一个完整对象，你不需要“额外传”——但你要用它的字段，就得在模板里显式取出来再传，因为过滤器内部没有作用域穿透能力：
-
{{ item | formatLabel(item.label, item.level) }}✅ 可行，item.label在模板中求值后作为第二参数传入 -
{{ item | formatLabel }}❌ 如果过滤器内部试图读item.label，会报Cannot read property 'label' of undefined，因为此时函数只收到第一个参数（即item），但没传其他字段 - 所以真正安全的做法是：要么传整个
item（{{ item | formatLabel(item) }}），要么只传需要的字段（{{ item | formatLabel(item.label) }}）
比过滤器更靠谱的替代方案
过滤器在 Vue 3 已废弃，uni-app 3.x 项目也不再推荐使用；即使在 2.x 项目里，多参数场景下也容易出错、难调试、无法复用：
- 在
methods里写formatItem(item)，模板中调用{{ formatItem(item) }}—— 参数自由，可 debug，类型友好 - 用
computed预处理列表：formattedList: this.list.map(item => ({ ...item, displayLabel: this.formatLabel(item) })) - 复杂逻辑直接抽成工具函数，再在 methods 或 setup 中 import 使用，避免过滤器里塞副作用（如请求、log）
真正容易被忽略的是：过滤器无法做类型推导、不支持 TS 参数提示、v-for 中高频调用时无缓存——这些隐性成本，远比“少写几个字”更值得警惕。
