java BigDecimal任意精度整数如何避免错

在 Java 里用 BigDecimal 处理“任意精度整数”（或高精度数值）时，所谓“出错”通常来自 精度丢失、舍入错误、比较错误、构造方式不当 等。下面按常见坑和正确做法说明。

一、最核心原则：不要使用 double 构造 BigDecimal

❌ 错误写法

BigDecimal a = new BigDecimal(0.1);

0.1 在 double 中本就不精确，BigDecimal 会把这种误差原样保留。

✅ 正确写法

BigDecimal a = new BigDecimal("0.1");

或

BigDecimal a = BigDecimal.valueOf(0.1);

valueOf 内部使用 Double.toString，比 new BigDecimal(double) 安全。

二、整数场景：优先使用 BigInteger

如果你明确是任意精度整数：

BigInteger x = new BigInteger("123456789012345678901234567890");

BigInteger 不会涉及小数、舍入问题，最安全。

只有在需要小数时才用 BigDecimal。

三、必须显式指定舍入模式（极易踩坑）

❌ 错误

BigDecimal r = a.divide(b);

当不能整除时直接抛：

ArithmeticException: Non-terminating decimal expansion

✅ 正确

BigDecimal r = a.divide(b, 10, RoundingMode.HALF_UP);

常用舍入模式：

• RoundingMode.HALF_UP（四舍五入）
• RoundingMode.DOWN
• RoundingMode.UNNECESSARY（要求必须整除）

四、比较大小不要用 equals

❌ 错误

a.equals(b)

equals 会比较标度（scale）：

new BigDecimal("1.0").equals(new BigDecimal("1.00")) // false

✅ 正确

a.compareTo(b) == 0

五、控制标度（scale）与精度

设置小数位

BigDecimal v = a.setScale(2, RoundingMode.HALF_UP);

设置有效数字（精度）

BigDecimal v = a.round(new MathContext(10));

六、避免精度“悄悄变化”

• 不要混用 double 计算后再转 BigDecimal
• 不要在循环中反复 divide 而不设精度
• 金额计算推荐：
  • 用 BigDecimal("0.00") 表示钱
  • 或整数分（long / BigInteger）

七、金额计算推荐实践（最稳）

BigDecimal price = new BigDecimal("19.99");
BigDecimal qty = new BigDecimal("3");

BigDecimal total = price.multiply(qty)
                        .setScale(2, RoundingMode.HALF_UP);

八、总结 Checklist

✅ 用字符串或 valueOf 构造
✅ 整数用 BigInteger
✅ 除法必须指定 scale + RoundingMode
✅ 比较用 compareTo
✅ 金额用 setScale(2, HALF_UP)

如果你有具体场景（比如：银行金额、大数阶乘、分布式计算、JSON 传输），我可以给更针对性的写法。