前端精确数字运算：用 BigNumber.js 解决 JS Number 精度问题

如果不想依赖包管理器，也可以直接通过 CDN 引入：

<script src="https://cdn.jsdelivr.net/npm/bignumber.js/bignumber.min.js"></script>
<script>
  const num = new BigNumber('123456789.123456789');
  console.log(num.toString());
</script>

配置选项

BigNumber.js 提供了全局配置，影响所有后续实例。常用配置项如下：

BigNumber.config({
  DECIMAL_PLACES: 10,           // 默认小数点后保留位数
  ROUNDING_MODE: BigNumber.ROUND_HALF_UP, // 默认舍入模式
  EXPONENTIAL_AT: [-15, 20]     // 科学计数法触发范围
});

• DECIMAL_PLACES：控制精度。
• ROUNDING_MODE：定义舍入策略，如向上取整 (ROUND_UP)、向下取整 (ROUND_DOWN)、四舍五入 (ROUND_HALF_UP) 等。
• EXPONENTIAL_AT：当数字小于 1e-15 或大于 1e20 时自动转为科学计数法。

你也可以在创建实例时传入局部配置，优先级高于全局配置：

const num = new BigNumber('1.23456789', { DECIMAL_PLACES: 5 });
console.log(num.toString()); // 输出：1.23457

常用 API 速查

基本运算

支持加法、减法、乘法、除法及取模。注意方法名是驼峰命名，如 plus, minus。

const a = new BigNumber('10');
const b = new BigNumber('3');

console.log(a.plus(b).toString());   // 加法：13
console.log(a.minus(b).toString());   // 减法：7
console.log(a.times(b).toString());   // 乘法：30
console.log(a.div(b).toString());     // 除法：3.3333333333333333333
console.log(a.mod(b).toString());     // 取模：1

高级功能

幂运算与绝对值

const num = new BigNumber('2');
console.log(num.pow(10).toString());  // 幂运算：1024

const negNum = new BigNumber('-123.45');
console.log(negNum.abs().toString()); // 绝对值：123.45

舍入处理

const num = new BigNumber('1.23456789');
console.log(num.toFixed(2, BigNumber.ROUND_UP));      // 1.24
console.log(num.toFixed(2, BigNumber.ROUND_DOWN));    // 1.23
console.log(num.toFixed(2, BigNumber.ROUND_HALF_UP)); // 1.23

比较操作

const a = new BigNumber('10');
const b = new BigNumber('20');

console.log(a.comparedTo(b));        // -1 (a < b)
console.log(a.isEqualTo(b));         // false
console.log(a.isGreaterThan(b));     // false
console.log(a.isLessThan(b));        // true

格式化输出

const num = new BigNumber('123456789.123456789');
console.log(num.toString());          // 默认格式
console.log(num.toFormat(2));         // 123,456,789.12 (带千分位)
console.log(num.toExponential(2));    // 1.23e+8 (科学计数法)

链式调用

BigNumber 的设计非常适合链式操作，代码更简洁：

const result = new BigNumber('10')
  .plus('5')   // 15
  .times('2')  // 30
  .div('3')    // 10
  .pow('2');   // 100

console.log(result.toString()); // 输出：100

总结

BigNumber.js 弥补了 JavaScript 原生 Number 类型在十进制精度上的短板。相比其他库，它的优势在于默认行为符合人类直觉（不自动截断），且 API 设计直观。

• BigInt：仅处理整数，无法处理小数。
• Decimal.js：功能类似，但 BigNumber.js 在社区中更为普及。
• Math.js：功能强大但较重，适合复杂数学计算。

在实际开发中，涉及金额、货币、加密资产的场景，建议直接使用 BigNumber.js 进行数值处理，避免后期因精度问题引发资损。