uni-app全局过滤器在ts中无类型提示是因为uni.appconfig.filters是运行时挂载的，ts编译期无法感知，其类型默认为空对象{}；需通过模块合并扩展uniapp.appconfig接口，显式声明filters及其函数签名，并在main.ts中同步注册匹配的同步函数。
uni-app全局过滤器在TS中为什么没有类型提示
因为 uni.appConfig.filters 是运行时挂载的，TypeScript 编译期无法感知你加了哪些过滤器，filters 在类型定义里默认是空对象 {}，所以模板里写 {{ value | myFilter }} 会报错“Property 'myFilter' does not exist on type '{}'”。
怎么给 uni.appConfig.filters 补全类型
核心思路是用模块合并（declaration merging）扩展 UniApp.AppConfig 接口，让 TS 知道你加了哪些过滤器及其参数/返回类型。
推荐在项目根目录新建 types/uni-app.d.ts（确保被 tsconfig.json 的 include 或 typeRoots 覆盖）：
declare module '@dcloudio/uni-app' {
interface AppConfig {
filters?: {
formatDate: (date: string | number, fmt?: string) => string
toUpper: (str: string) => string
// 按需添加其他过滤器签名
}
}
}
注意：filters 是可选的（?），且必须是具体函数签名对象，不能写 Record<string function></string> —— 否则模板中仍无参数提示。
注册过滤器时必须和类型声明严格一致
类型声明只是“告诉 TS 有这些方法”，实际注册还得在 JS/TS 代码里做，且函数签名要对得上，否则运行时可能出错或类型检查失效：
Galileo TypeScript sdk
下载
完整的Galileo AI平台 TypeScript/JS SDK 参考，用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。
- 在
main.ts或app.ts中注册前，先确保类型已加载（types/uni-app.d.ts被识别） -
uni.appConfig.filters必须显式初始化为对象，不能直接赋值属性（否则 TS 可能推断为any） - 函数参数个数、顺序、类型必须与声明完全匹配，比如声明了
(date: string | number, fmt?: string)，就不能少传fmt或传成number
示例注册：
// main.ts
uni.appConfig.filters = {
formatDate(date, fmt = 'yyyy-MM-dd') {
// 实现略
return '2024-01-01'
},
toUpper(str) {
return str.toUpperCase()
}
}
模板中使用过滤器仍需注意兼容性
虽然类型补全后 {{ value | formatDate }} 不再报错，但 uni-app 的 Vue 模板编译器本身不校验过滤器是否存在或类型是否匹配 —— 这纯属 TS 开发阶段的提示增强。
容易忽略的点：
- H5 和小程序平台对过滤器的支持一致，但如果你在
filters里写了异步逻辑（比如调 API），它不会生效 —— 过滤器必须是同步函数 - 如果过滤器名拼错（如写成
formateDate），TS 不会报错（因为类型声明里没这个 key），但运行时返回undefined，模板渲染为空 - Vue 3 的
setup语法糖中无法直接使用全局过滤器，需改用计算属性或useFilter类似封装（uni-app 目前未提供官方 hook，得自己写）
真正起作用的永远是运行时注册 + 类型声明双匹配；漏掉任意一环，就只剩“能跑”但没提示、难维护。
