accounting-js vs numeral：财务与通用格式化深度对比

在 JavaScript 项目中处理数字展示时，accounting-js 和 numeral 是两个经典的选择。它们都能将原始数字转换为用户友好的字符串，但设计目标和适用场景有明显区别。让我们从实际工程角度对比它们的用法和限制。

💰 货币格式化：专用 vs 通用

accounting-js 专为金钱设计，API 直接暴露货币符号、精度和分隔符参数。

• 默认行为符合财务标准（如负数用括号表示）。
• 不需要记忆复杂的格式字符串。

// accounting-js: 直接配置货币参数
import accounting from 'accounting-js';

accounting.formatMoney(1234567.89, "$", 2, ",", ".");
// 输出：$1,234,567.89

accounting.formatMoney(-1234.50, "¥", 2);
// 输出：¥(1,234.50) - 默认负数格式

numeral 使用格式字符串模板，更灵活但需要手动定义货币符号。

• 适合混合格式（如同时处理货币和普通数字）。
• 负数格式需手动配置。

// numeral: 使用格式字符串
import numeral from 'numeral';

numeral(1234567.89).format('$0,0.00');
// 输出：$1,234,567.89

numeral(-1234.50).format('$0,0.00');
// 输出：-$1,234.50 - 需手动处理负数样式

🔢 通用数字格式化：灵活性对比

accounting-js 仅提供基础的数字格式化，功能单一。

• 主要关注千位分隔和小数精度。
• 不支持百分比、字节或时间格式。

// accounting-js: 仅支持基础数字
import accounting from 'accounting-js';

accounting.formatNumber(10000, 2, ",", ".");
// 输出：10,000.00

numeral 支持多种数据类型格式化，适合复杂场景。

• 内置百分比、字节、时间等格式。
• 一个库解决多种展示需求。

// numeral: 支持多种格式
import numeral from 'numeral';

numeral(0.75).format('0%');      // 输出：75%
numeral(1024).format('0b');      // 输出：1KB
numeral(10000).format('0,0');    // 输出：10,000

🌍 本地化与维护状态

accounting-js 维护相对稳定，但功能更新缓慢。

• 适合对货币格式有固定需求的项目。
• 本地化需手动传入符号和分隔符。

// accounting-js: 手动配置本地化
accounting.formatMoney(1000, "€", 2, ".", ",");
// 欧洲格式：€1.000,00

numeral 社区普遍认为已进入维护模式，更新极少。

• 存在潜在的安全和维护风险。
• 本地化同样需手动配置或加载语言包。

// numeral: 加载语言包（需额外配置）
numeral.locale('de');
numeral(1000).format('0,0');
// 输出：1.000 (取决于语言包支持)

🤝 相似之处：共同的基础能力

尽管侧重点不同，这两个库在基础功能上有重叠。

1. 📏 都是轻量级工具库

• 不包含复杂的依赖，易于集成。
• 适合浏览器和 Node.js 环境。

// 两者都支持 CommonJS 和浏览器全局变量
// accounting.js: window.accounting
// numeral: window.numeral

2. 🔄 都支持反向解析（Unformat）

• 可将格式化后的字符串转回数字。
• 适合处理表单输入。

// accounting-js: 反格式化
accounting.unformat("$1,000.00");
// 输出：1000

// numeral: 反格式化
numeral("$1,000.00").value();
// 输出：1000

3. ⚙️ 都允许自定义分隔符

• 可调整千位和小数分隔符以适应不同地区。
• 但都不如原生 Intl API 自动识别 locale 方便。

// 两者都需手动指定分隔符
// accounting: formatNumber(val, precision, thousand, decimal)
// numeral: 依赖格式字符串如 '0,0.00'

📊 总结：关键差异表

💡 最终建议

accounting-js 就像一把专用的财务尺子 📏——适合对货币显示有严格要求的场景，如电商价格、金融报表。它的默认行为更符合会计习惯，减少配置错误。

numeral 就像一把多功能瑞士军刀 🔪——适合需要格式化多种数据类型（百分比、字节等）的旧项目。但在新项目中，建议优先考虑原生 Intl.NumberFormat 以获得更好的本地化支持和长期维护保障。

核心思考：如果项目必须依赖第三方库，且主要是货币展示，选 accounting-js 更稳妥。如果需要通用格式化且无法使用原生 API，numeral 可用但需意识到维护风险。现代开发中，原生 Intl 通常是更优解。