dinero-best-practices

此技能旨在为在 JavaScript 与 TypeScript 环境中使用 Dinero.js 库管理金钱的开发者提供专家建议。它专为软件工程师、全栈开发人员与金融应用架构师设计，协助处理货币精确度、不可变性与类型安全逻辑的复杂挑战。该技能提供关于避免浮点数误差、错误货币四舍五入及不当缩放等常见陷阱的实务指导，确保您的金融代码稳健且适用于正式环境。

• 验证对象创建模式，确保金额以货币最小单位作为整数传递，以防止精确度损失。

• 提供算术运算建议，强制使用 allocate 取代除法，并指导如何使用缩放后的数值进行百分比运算。

• 执行精确度管理，协助开发者在标准的 number 计算器与处理大额财务的 bigint 计算器之间做出选择。

• 指导 Tree-shaking 与模块导入，确保套件体积保持精简，并确保 bigint 与标准精确度模块的依赖性匹配。

• 推广不可变性原则，提醒开发者所有运算皆会返回新对象，这对预测性状态管理至关重要。

• 提供货币格式化明确规则，包含如何处理如 JPY 等零指数货币，以及如何正确修剪小数位数。

• 当导入 dinero.js、dinero.js/currencies 或 dinero.js/bigint 时触发，以维护架构一致性。

• 支持复杂金融计算的调试，例如增值税（VAT）分配、多币种转换以及基于百分比的价格调整。

• 适用于代码审查、重构阶段，或在项目中建立新的金融模块时使用。

• 基于金钱运算复杂且需要特殊抽象化以避免标准 JavaScript 数字陷阱的原则运行。

• 协助弥合财务精确度的业务需求与 IEEE 754 浮点数实际限制之间的鸿沟。