更新记录

1.0.1（2026-08-26） 下载此版本

• 后缀语义修正：suffix（默认 '+'）仅作用于万/亿级缩写——数字被截断才表示"不止于此"； 万以下原样精确显示，不带后缀（999 而非 999+）。

平台兼容性

uni-app(5.24)

uni-app x(5.24)

wc-format

展示层数据格式化工具（纯函数、无状态、无依赖）。

使用

小程序端请直接从具体模块导入（.../wc-format/commons/format）。 mp-weixin 编译器会把纯 re-export 的 index.ts 编译成空模块。

import { formatCompactNumber, formatSocialCount } from '@/uni_modules/wc-format/commons/format'

大数值缩写：formatCompactNumber

规则：

• < 1万：原样精确显示（向下取整），不带后缀——数字无截断无需 "+"
• ≥ 1万 < 1亿：万；整数万不带小数点（12万 而非 12.0万），非整数保留 1 位；带 +（默认 suffix）
• ≥ 1亿：亿，同上
• 非法输入（null/undefined/NaN/负数）：'0'

社交计数：formatSocialCount

formatCompactNumber(value, '+') 的语义化别名——关注数/粉丝数/浏览量等：

formatSocialCount(999)    // '999'
formatSocialCount(11000)  // '1.1万+'

范围说明

刻意不包含（保持简单）：

• 时间格式化（独立插件 wc-time 的范畴）
• 距离/文件大小格式化（出现需求时另行增加）