compactdisplay 是 intl.numberformat 的选项，仅支持 "short" 和 "long" 模式，配合 locale: "zh-cn" 可显示“万”“亿”，但属浏览器内置行为，不保证完全符合中文习惯，且需注意兼容性与边界值。
compactDisplay 是什么，它能直接输出“万”“亿”吗
compactDisplay 是 Intl.NumberFormat 的一个选项，但它本身**不生成中文单位如“万”“亿”**。它只支持 "short" 和 "long" 两种模式，且单位语言由 locale 决定——比如 zh-CN 下 12000 用 { compactDisplay: "short" } 会显示为 "1.2万"，但这是浏览器内部实现的，不是你手动拼的，也不保证所有数字都符合中文习惯（例如 10000000 在部分 Chrome 版本中可能显示为 "1000万" 而非 "1千万"）。
关键点在于：compactDisplay: "short" + locale: "zh-CN" 是目前最接近“业务极简显示”的原生方案，但必须验证实际渲染结果，不能假设它总是按预期分节。
为什么直接 new Intl.NumberFormat('zh-CN', { compactDisplay: 'short' }) 有时不生效
常见失效原因有三个：
- 浏览器版本太低：Firefox 直到 115+ 才支持
compactDisplay，旧版 Safari 完全不支持；可查 caniuse 确认目标环境 -
useGrouping: false被误设：该选项会禁用千分位和紧凑格式，导致compactDisplay被忽略 - 数值过小或过大：低于
1000或超出当前 locale 支持的紧凑范围（如zh-CN通常支持到“万亿”，再大可能回落为科学计数法）
实操建议：
- 始终显式设置
useGrouping: true（默认值，但显式写更安全） - 对关键数值做降级兜底，比如
123456789在不支持时 fallback 到手动除法 + 单位映射 - 测试边界值：
999、1000、9999、10000、9999999、10000000
如何安全兼容不支持 compactDisplay 的环境
不要只依赖 try/catch 判断构造函数是否报错——它可能静默失败。更可靠的方式是运行时探测：
function hasCompactDisplaySupport() {
try {
const fmt = new Intl.NumberFormat('zh-CN', { compactDisplay: 'short' });
return typeof fmt.format === 'function' && fmt.format(10000) !== '10000';
} catch {
return false;
}
}
若探测失败，建议用轻量级 fallback 函数，而不是引入完整数字库：
- 预定义中文单位数组：
['', '万', '亿', '万亿'] - 用
Math.log10(Math.abs(num)) / 4 | 0快速定位单位层级（注意处理负数和小数） - 避免用
toLocaleString多次格式化，统一走Intl.NumberFormat('zh-CN', { maximumFractionDigits: 1 })控制小数位
示例 fallback 片段：
const UNITS = ['', '万', '亿', '万亿'];
function formatCompact(num) {
if (hasCompactDisplaySupport()) {
return new Intl.NumberFormat('zh-CN', {
notation: 'compact',
compactDisplay: 'short',
maximumFractionDigits: 1
}).format(num);
}
// fallback...
const abs = Math.abs(num);
let unitIdx = 0;
while (abs >= 10000 && unitIdx <h3>容易被忽略的细节：小数精度与负数符号位置</h3><p><code>Intl.NumberFormat</code> 的 <code>maximumFractionDigits</code> 对 compact 显示的影响很隐蔽：</p>
-
12345.678在maximumFractionDigits: 1下显示为"1.2万"，但12345.678本身四舍五入后是12345.7，再缩略——不是先缩略再保留一位小数 - 负数如
-12345会显示为"-1.2万"，减号在单位前，符合中文习惯；但如果你手动拼接，容易写成"负1.2万"或"-1.2万"位置错乱 -
minimumIntegerDigits和minimumFractionDigits对 compact 模式基本无效，别白费力气配
真正要控制的是 notation: "compact"（必须显式声明，否则 compactDisplay 可能被忽略），以及 maximumSignificantDigits（影响整体有效数字，比 maximumFractionDigits 更底层）。
最后提醒一句：不同 locale 下“万”的语义并不一致——ja-JP 里 10000 是“1万”，但 ko-KR 默认不启用 compact，需额外配置。如果产品要出海，别只测 zh-CN。
