JavaScript 数字格式化库：架构选型与实战对比

在前端开发中，将原始数值转换为用户友好的格式（如货币、百分比、千位分隔）是常见需求。虽然现代浏览器提供了原生 Intl.NumberFormat API，但在处理复杂场景、旧浏览器兼容或特定生态系统（如 D3）时，第三方库仍有其价值。本文将深度对比 accounting-js、d3-format、format-number、mathjs、numeral 和 sprintf-js，帮助你做出架构决策。

⚠️ 维护状态与生命周期：首要考量

在选择库之前，必须了解其维护状态。使用已停止维护的库会引入安全风险和技术债务。

numeral 和 accounting-js 属于早期经典库，但目前已进入停止维护状态。

• numeral 最后更新停留在数年前，社区已普遍建议迁移。
• accounting-js 功能单一，多年无版本迭代。

d3-format 和 mathjs 是活跃维护的库。

• d3-format 作为 D3 生态的一部分，更新频繁，稳定性高。
• mathjs 持续更新，适合科学计算场景。

sprintf-js 和 format-number 处于稳定期。

• 功能成熟，变更较少，适合特定用途。

💡 建议：除非维护旧系统，否则避免在新项目中使用 numeral 和 accounting-js。

💰 货币格式化实战：语法与灵活性

货币格式化是最常见的需求，涉及符号、千位分隔和小数位数。

accounting-js 提供专用的货币函数，API 非常直观。

import accounting from 'accounting-js';

// 格式化为货币
const money = accounting.formatMoney(1234567.89, '$', 2);
// 输出：$1,234,567.89

d3-format 使用格式说明符字符串，灵活性极高。

import { format } from 'd3-format';

// 定义格式：美元，千位分隔，2 位小数
const usd = format('$,.2f');
const money = usd(1234567.89);
// 输出：$1,234,567.89

numeral 使用链式调用和模板字符串（已弃用，仅作对比）。

import numeral from 'numeral';

// 链式格式化
const money = numeral(1234567.89).format('$0,0.00');
// 输出：$1,234,567.89

mathjs 主要通过配置对象控制精度，货币符号需手动处理。

import { format } from 'mathjs';

// 控制精度，符号需自行拼接
const num = format(1234567.89, { precision: 2 });
const money = '$' + num.replace(/\B(?=(\d{3})+(?!\d))/g, ',');
// 输出：$1,234,567.89 (需额外处理千位符)

sprintf-js 使用 C 风格占位符，不直接支持货币符号。

import sprintf from 'sprintf-js';

// 仅处理数字结构，符号需手动添加
const num = sprintf('%0,.2f', 1234567.89);
const money = '$' + num;
// 输出：$1,234,567.89

format-number 提供简单的选项对象配置。

import formatNumber from 'format-number';

// 通过配置对象控制
const formatter = formatNumber({ style: 'currency', currency: 'USD' });
const money = formatter(1234567.89);
// 输出：$1,234,567.89 (依赖底层实现)

🎯 精度控制与舍入行为

不同库对小数舍入的处理方式不同，这在金融场景中至关重要。

d3-format 支持多种舍入类型（如向上、向下、最近）。

import { formatRound } from 'd3-format';

// 强制四舍五入
const round = formatRound('.2f');
console.log(round(1.235)); // 1.24

mathjs 允许指定有效数字位数，适合科学计算。

import { format } from 'mathjs';

// 指定有效数字精度
console.log(format(12345, { precision: 3 })); // 1.23e+4

numeral 默认四舍五入，但配置项有限。

import numeral from 'numeral';

console.log(numeral(1.235).format('0.00')); // 1.24

accounting-js 默认四舍五入，可配置精度。

import accounting from 'accounting-js';

console.log(accounting.formatMoney(1.235, '', 2)); // 1.24

sprintf-js 遵循标准 C 库舍入规则。

import sprintf from 'sprintf-js';

console.log(sprintf('%.2f', 1.235)); // 1.24

format-number 通常封装了原生行为，配置较简单。

import formatNumber from 'format-number';

const formatter = formatNumber({ round: 2 });
console.log(formatter(1.235)); // 1.24

🧩 通用性与生态系统集成

除了数字格式化，库的通用性和与其他工具的集成能力也是考量点。

d3-format 是数据可视化领域的标准。

• 与 d3-scale、d3-axis 无缝配合。
• 适合图表标签、坐标轴格式化。

mathjs 是数学计算的全能工具。

• 支持表达式解析、矩阵、复数。
• 格式化只是其众多功能之一。

sprintf-js 专注于字符串插值。

• 适合日志输出、动态消息生成。
• 不局限于数字，可格式化日期、对象。

numeral / accounting-js / format-number 专注于数字。

• 功能单一，集成成本低，但扩展性弱。

📊 总结对比表

💡 架构师建议

首选方案：对于大多数现代前端项目，优先使用原生 Intl.NumberFormat。它无需依赖，支持所有主流浏览器，且性能最佳。

特定场景选择：

• 数据可视化：选择 d3-format。它与图表库配合最好，格式控制最精细。
• 复杂数学计算：选择 mathjs。如果你已经用它做计算，顺便用它格式化可以减少依赖。
• 日志与模板：选择 sprintf-js。当你需要类似后端的字符串格式化逻辑时。
• 旧项目维护：如果现有代码大量使用 numeral 或 accounting-js，建议制定计划迁移至 d3-format 或原生 API，以避免未来兼容性风险。

最终结论：库的选择应基于项目具体需求。不要为了简单的数字格式化引入重型库（如 mathjs），也不要在新项目中使用已停止维护的库（如 numeral）。保持依赖精简，优先利用原生能力。