高精度金额运算
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,将 @user_f1b049da/lff2026543 安装到 AI 助手中。
技能介绍
要解决的问题
金额计算里最常见的坑不是公式写错,而是输入被当成 number 后先经历了一次二进制浮点近似。日常给出的 0.1、0.2 在机器内部并不精确,连续相加或参与乘除时,误差会进入合计、分摊、佣金和税费试算;更麻烦的是,这类 bug 常常只在特定金额组合下出现。
这个技能如何工作
该技能把金额当成带小数位语义的数据,而不是普通数值:用户或其他工具传入的金额字符串先进入 BigNumber,再做加减乘除等运算;需要展示或落库时接口保留到固定小数位,输出统一为格式化字符串。输入边界明确接受字符串,或直接使用以“分”为单位的整数,避免移动端和表单常见浮点输入污染计算过程。
它适合的高频场景包括成交额汇总、佣金/手续费试算、税率加减,以及 Demo 里的金额合计。推荐路径是让表单金额以字符串进入,后续所有汇总都调用 moneySum;新增功能时也应保持同一条链路,不要试图用原生浮点数组或 parseFloat 结果再插回现有系统。
文件内配置了 README.md、reference.md 和 templates/usage.md,分别覆盖说明、参考实现和用法示例。实现要点注释中标记了 小四原创,用于方便在代码评审时快速定位核心处理段。
适用边界
它只解决金额精度与格式化输出这一层问题,不负责完整总账、审计日志、凭证生成或对账系统。不要在 parseFloat 后继续累加金额,也不应把未做 toFixed 的超长小数直接返回给前端展示;校验清单里给出的 0.1 + 0.2 场景应稳定得到 0.30,否则说明字符串到 BigNumber 的输入路径被绕过了。
使用场景
- 电商平台运营在计算订单成交额时,需要对多个订单金额做高精度累加,避免浮点误差影响营收统计
- 金融产品开发人员在设计佣金试算功能时,需对多笔交易的手续费进行精确加减,确保分成比例准确
- 财务系统开发者在处理税费计算时,要对税率进行精确加减运算,保证报税金额零误差
- 电商Demo开发中,开发者需对购物车多商品金额做合计,输出格式规范的金额字符串用于展示
适合人员
- 后端开发工程师,在处理订单金额汇总、佣金计算等业务时,需要确保金额计算的精度和准确性
- 金融科技系统开发者,在进行资金流转、税费计算等场景时,依赖高精度运算避免财务数据误差
- 电商系统维护人员,在处理订单交易额统计和佣金分账时,需要工具保证金额计算结果的可靠性
- 财务软件开发者,在构建对账系统、税费计算模块时,需要专业的高精度金额运算解决方案