前端精确数字运算：BigNumber.js 实战与原理

全局配置

BigNumber.js 支持全局配置默认精度和舍入模式，所有实例均生效：

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

也可以在创建实例时传入局部配置覆盖全局设置：

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

核心方法详解

创建实例

建议始终传入字符串以避免解析时的精度损失：

const num = new BigNumber('123456789.123456789');
console.log(num.toString());

基本运算

支持加、减、乘、除、取模等操作，返回新的 BigNumber 对象：

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.333...
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

比较操作

注意不要直接用 === 比较 BigNumber 对象，应使用内置方法：

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());

典型应用场景与精度对比

大数精度丢失

原生 JS 无法准确表示超过 53 位有效数字的整数：

// 原生 JavaScript
console.log(9007199254740992 === 9007199254740993); // true (错误)

// 使用 BigNumber.js
const num1 = new BigNumber('9007199254740992');
const num2 = new BigNumber('9007199254740993');
console.log(num1.eq(num2)); // false (正确)

小数运算精度

浮点数二进制转换导致的误差：

// 原生 JavaScript
console.log(0.1 + 0.2); // 0.30000000000000004

// 使用 BigNumber.js
const num1 = new BigNumber('0.1');
const num2 = new BigNumber('0.2');
console.log(num1.plus(num2).toString()); // 0.3

大数乘除法精度

在区块链或金融场景中，单位换算（如 ETH 与 Wei）必须精确：

// 原生 JavaScript
const weiAmount = 1000000000000000001; // 1 ETH + 1 wei
const ethAmount = weiAmount / 1000000000000000000;
console.log(ethAmount); // 1.0000000000000002 (错误)

// 使用 BigNumber.js
const wei = new BigNumber('1000000000000000001');
const eth = wei.div(new BigNumber('1000000000000000000'));
console.log(eth.toString()); // 1.000000000000000001 (正确)

总结

BigNumber.js 专为解决 JS 十进制小数精度丢失而生。相比其他库，它在功能复杂度与精度控制之间取得了平衡。对于金融、电商、区块链等对数值敏感的场景，它是首选方案。在实际开发中，记得优先使用字符串初始化，并合理配置全局精度参数。