前端货币与数字格式化库深度对比：accounting vs currency.js vs dinero.js vs numeral

在前端开发中，处理货币和数字格式化看似简单，实则暗藏陷阱。JavaScript 的原生浮点数计算容易导致精度丢失，而不同地区的货币格式差异巨大。accounting、currency.js、dinero.js 和 numeral 是生态中常见的解决方案，但它们的设计目标和维护状态截然不同。本文将从维护状态、格式化能力、计算安全性和 API 设计四个维度进行深度对比。

⚠️ 维护状态与风险提示

选择第三方库时，维护状态是首要考量因素。一个不再维护的库可能包含未修复的安全漏洞，且无法兼容未来的 JavaScript 版本。

accounting 和 numeral 均已停止维护多年。

• 最后更新时间大约在 2017 年左右。
• 社区不再修复 Bug 或添加新功能。
• 在新项目中使用它们会带来技术债务。

currency.js 和 dinero.js 目前相对活跃。

• currency.js 专注于轻量级场景，更新稳定。
• dinero.js 专注于金融级精度，v1 版本稳定，v2 版本正在重构中。

// 风险提示：以下库已不再维护，新项目慎用
import accounting from 'accounting'; 
import numeral from 'numeral'; 

// 推荐：以下库维护状态较好
import currency from 'currency.js';
import Dinero from 'dinero.js';

🎨 格式化能力对比

格式化是这些库最基础的功能。我们需要观察它们如何处理千位分隔符、小数位以及货币符号。

accounting 提供专门的货币格式化方法，配置项较为传统。

// accounting: 专门针对货币
accounting.formatMoney(12345678, { symbol: '¥', precision: 2 });
// 输出：¥12,345,678.00

currency.js 链式调用，默认处理货币符号，支持简单配置。

// currency.js: 链式格式化
currency(12345678, { symbol: '¥' }).format();
// 输出：¥12,345,678.00

dinero.js 基于对象创建，格式化方法更严谨，支持国际化参数。

// dinero.js: 基于对象实例
Dinero({ amount: 12345678, currency: 'CNY' }).format();
// 输出：¥12,345,678.00 (取决于环境配置)

numeral 通用数字格式化，需要通过字符串模板定义格式，灵活性高但易出错。

// numeral: 字符串模板定义格式
numeral(12345678).format('¥0,0.00');
// 输出：¥12,345,678.00

🧮 计算安全性与精度

这是区分普通格式化库和金融库的关键。JavaScript 的 0.1 + 0.2 !== 0.3 问题在货币计算中是致命的。

accounting 本质上是对原生 Number 的包装，不解决 浮点数精度问题。

// accounting: 无安全计算，直接使用原生数学
// 不推荐用于计算，仅用于展示
const total = 0.1 + 0.2; 
accounting.formatMoney(total); // 可能显示 ¥0.30000000000000004

currency.js 内部使用整数运算来处理小数，避免了大部分精度问题，适合简单加减。

// currency.js: 内部处理精度
const val1 = currency(0.1);
const val2 = currency(0.2);
val1.add(val2).format(); // 输出：¥0.30

dinero.js 严格使用整数（最小货币单位）进行计算，完全避免浮点数误差，最安全。

// dinero.js: 基于最小单位（如分）计算
const d1 = Dinero({ amount: 10, currency: 'USD' }); // 10 分
const d2 = Dinero({ amount: 20, currency: 'USD' }); // 20 分
d1.add(d2).format(); // 输出：$0.30

numeral 同样基于原生 Number，不解决 精度问题，仅提供格式化。

// numeral: 无安全计算
const total = 0.1 + 0.2;
numeral(total).format('0.00'); // 可能显示 0.30，但内部值仍不精确

🛠️ API 设计风格

API 的设计影响代码的可读性和可维护性。

accounting 采用传统函数式调用，配置通过对象传递。

// accounting: 函数 + 配置对象
accounting.formatNumber(1000, { thousand: ',', decimal: '.' });

currency.js 采用链式调用，代码流畅，适合快速开发。

// currency.js: 链式调用
currency(1000).multiply(2).format();

dinero.js 采用不可变对象模式，每次操作返回新实例，便于调试和追踪。

// dinero.js: 不可变实例
const d = Dinero({ amount: 1000, currency: 'USD' });
const newD = d.add(d); // d 不变，newD 是新对象

numeral 采用链式调用，但依赖字符串模板，类型安全性较差。

// numeral: 链式 + 字符串模板
numeral(1000).format('0,0');

📊 总结对比表

💡 架构师建议

在选择这些库时，请根据业务场景的复杂度做出决定。

对于现代新项目：

• 如果涉及 金钱计算，首选 dinero.js。它的不可变设计和整数运算能避免很多财务 bug。虽然 API 稍微繁琐，但安全性值得付出。
• 如果只是 简单展示 货币，且希望代码轻量，currency.js 是很好的平衡点。它比 dinero.js 简单，比 accounting 安全。
• 对于 非货币数字（如百分比、文件大小），建议优先使用原生 Intl.NumberFormat，而不是 numeral。原生 API 性能更好且无依赖。

对于旧项目维护：

• 如果现有代码使用了 accounting 或 numeral，且没有计算精度问题，可以暂时保留。但在新功能开发中，应逐步迁移到更安全的方案。

最终结论： dinero.js 是处理金融逻辑的专业工具 — 安全但较重。currency.js 是前端展示的轻量利器 — 简单且够用。accounting 和 numeral 已成为历史 — 除非维护旧代码，否则不应再引入新项目。