解决 JavaScript 精度丢失：BigNumber.js 核心用法与场景

• DECIMAL_PLACES：控制精度。
• ROUNDING_MODE：定义舍入策略，如向上取整、向下取整、四舍五入等。
• EXPONENTIAL_AT：当数字过大或过小时自动转为科学计数法的阈值。

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

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

核心 API 实战

1. 创建实例

务必以字符串形式传入数字，避免初始化时就发生精度丢失。

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

2. 基本运算

支持加减乘除及取模，返回新的 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.3333333333333333333
console.log(a.mod(b).toString());     // 取模：1

3. 幂运算与绝对值

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

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

4. 舍入与格式化

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

// 格式化输出
console.log(num.toFormat(2));         // 1.23
console.log(num.toExponential(2));    // 1.23e+0

5. 比较操作

原生 JS 的 === 比较浮点数不可靠，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

6. 链式调用

利用返回值是 BigNumber 对象的特性，可以流畅地组合多个操作。

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

console.log(result.toString()); // 100

典型场景对比

大数精度丢失

超过 $2^{53}-1$ 的数字在原生 JS 中会丢失精度。

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

// BigNumber.js
const n1 = new BigNumber('9007199254740992');
const n2 = new BigNumber('9007199254740993');
console.log(n1.eq(n2)); // false (正确)

小数运算误差

这是最常见的坑，BigNumber 能给出精确结果。

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

// BigNumber.js
const sum = new BigNumber('0.1').plus(new BigNumber('0.2'));
console.log(sum.toString()); // 0.3

区块链与大数除法

处理加密货币单位转换时，精度至关重要。

// 原生 JS
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 专为解决 JavaScript 十进制小数精度问题而生。相比其他库，它在功能复杂度与精度控制之间取得了很好的平衡。如果你正在开发涉及金额计算、科学统计或区块链交互的前端应用，引入它是保障数据准确性的关键一步。