uni-app 小程序端不支持过滤器,因 vue 3 已移除 filter api 且小程序编译阶段跳过 filters 解析;需用纯函数 formatfilesize 统一处理单位转换。

uni-app 里不能用过滤器(filter)实现文件大小单位转换——不是写法问题,而是 Vue 3 已移除 filter API,且所有小程序端(微信、支付宝、字节等)在编译阶段直接跳过 filters 解析,根本不会执行。
你写的 <code>{{ size | toKB }} 在 H5 可能显示正常,但在真机小程序里永远原样输出,连报错都不会有。这不是 bug,是 uni-app 跨端机制决定的底层限制。
为什么 toLocaleString 或 filter 都不适用于文件大小单位转换
文件大小单位转换(如 1024000 → "1.02 MB")需要明确控制:
- 单位层级(B/KB/MB/GB)
- 小数位数(是否保留 1 位?2 位?)
- 是否补零("1 MB" 还是 "1.00 MB")
- 边界值处理(0、null、NaN、负数)
Number.prototype.toLocaleString() 不支持按字节自动升位,它只做本地化格式化,比如加千分位或小数点,但不会把 1048576 自动转成 "1 MB"。强行塞进去只会得到 "1,048,576",毫无意义。
真正可用的方案:封装纯函数 + 按需调用
把转换逻辑收束到 JS 层,确保所有平台走同一套代码路径:
- 在
utils/fileSize.js中定义:
export function formatFileSize(bytes, options = {}) {
const { decimals = 2, base = 1024 } = options
if (bytes == null || isNaN(bytes) || bytes const units = ['B', 'KB', 'MB', 'GB', 'TB']
let value = Math.abs(bytes)
let unitIndex = 0<p>while (value >= base && unitIndex </p><p>return <code>${value.toFixed(decimals)} ${units[unitIndex]}</code>
}</p>
- 在
setup()中导入并使用:
import { formatFileSize } from '@/utils/fileSize.js'
<p>// 示例数据
const file = { size: 2097152 } // 2MB</p><p>// 模板中直接调用
// {{ formatFileSize(file.size) }} → "2.00 MB"
// {{ formatFileSize(file.size, { decimals: 1 }) }} → "2.0 MB"</p>
- 注意:
v-model或响应式绑定中不要直接传函数调用结果,否则会丢失响应性;展示场景可直接调用,计算属性或watch处理更新场景更稳妥
常见错误:误用 sizeType 或压缩后体积当原始大小
上传图片时,很多人误以为 sizeType: ['compressed'] 能让 tempFiles[0].size 返回压缩后的体积——这是错的:
-
tempFiles[0].size始终是用户选择的原始文件体积(单位:字节),和sizeType无关 -
sizeType在 H5 完全不生效;在微信小程序中仅对 JPG 有效,且压缩质量不可控、体积不可预测 - 所以单位转换必须基于
res.tempFiles[0].size,而不是期望它“已经变小了”
跨平台兼容要注意的细节
不同平台对浮点精度、toFixed() 行为、Math.round() 的处理略有差异,尤其在低端安卓机或旧版小程序基础库中:
- 避免直接用
(bytes / 1024 / 1024).toFixed(2),它会在999999字节时错误显示为"1000.00 KB"而非"1.00 MB" - 必须逐级判断单位阈值,不能硬除固定层级
- 传入非数字时,
toFixed()会抛错,务必先做typeof bytes === 'number' && !isNaN(bytes)校验 - 微信小程序基础库低于 2.25.0 时,
Math.round()对超大整数可能有精度丢失,建议用Math.floor(value * 10 ** decimals) / 10 ** decimals替代toFixed
真正麻烦的从来不是“怎么算”,而是“怎么让所有端都算得一致且不出错”。单位转换看着简单,但一旦混进上传校验、列表渲染、错误提示里,边界情况就会层层叠加。别省那几行代码,老老实实做类型判断、单位跃迁和平台兜底。










