在 Java 开发中，尤其是金融、电商等对数值精度要求极高的领域，float 和 double 类型由于二进制存储机制，往往会导致精度丢失（例如 0.1 + 0.2 在计算机中并不完全等于 0.3）。BigDecimal 类正是为了解决这一问题而生。
本教程将带你深入理解 BigDecimal 的核心用法、常见陷阱以及最佳实践。
一、 核心概念与对象创建
BigDecimal 位于 java.math 包中，它支持任意精度的定点数运算。
1. 构造方法的"生死抉择"
创建 BigDecimal 对象时，构造方法的选择至关重要。
-
推荐使用 String 构造：这是最安全的方式，能够完全保留数值的精度。
-
慎用 double 构造 ：由于
double本身存储的就是近似值，直接使用new BigDecimal(double)会导致精度误差被带入对象中。 -
替代方案 ：使用
BigDecimal.valueOf(double)，其内部会将double转换为字符串处理，效果等同于推荐方式。import java.math.BigDecimal;
public class BigDecimalCreation {
public static void main(String[] args) {
// 错误示范：使用 double 构造，结果可能为 0.10000000000000000555...
BigDecimal bad = new BigDecimal(0.1);// 正确示范：使用 String 构造，结果为精确的 0.1 BigDecimal good = new BigDecimal("0.1"); // 正确示范：使用 valueOf，内部处理了精度问题 BigDecimal safe = BigDecimal.valueOf(0.1); }}
2. 常用常量
BigDecimal 内部预定义了一些常用常量，建议直接复用，避免重复创建对象：
BigDecimal.ZEROBigDecimal.ONEBigDecimal.TEN
二、 核心运算：加减乘除
BigDecimal 是不可变类（Immutable），这意味着每次运算都会返回一个新的 BigDecimal 对象，而不是修改原对象。因此，必须接收运算的返回值。
1. 基础四则运算
| 运算 | 方法 | 说明 |
|---|---|---|
| 加法 | add(BigDecimal augend) |
返回两个数的和 |
| 减法 | subtract(BigDecimal subtrahend) |
返回两个数的差 |
| 乘法 | multiply(BigDecimal multiplicand) |
返回两个数的积 |
| 除法 | divide(BigDecimal divisor) |
返回商（注意：除不尽时会报错） |
2. 除法运算的陷阱与处理
直接使用 divide 方法如果无法整除（例如 1 除以 3），会抛出 ArithmeticException。因此，开发中必须使用带精度和舍入模式的除法重载方法。
BigDecimal a = new BigDecimal("1.0");
BigDecimal b = new BigDecimal("3.0");
// 错误：除不尽，抛出异常
// a.divide(b);
// 正确：指定保留 2 位小数，并指定舍入模式（四舍五入）
BigDecimal result = a.divide(b, 2, BigDecimal.ROUND_HALF_UP);
// 或者使用 RoundingMode 枚举（推荐）
BigDecimal resultEnum = a.divide(b, 2, RoundingMode.HALF_UP);三、 舍入模式详解
在涉及除法或保留小数位时，必须指定舍入模式。RoundingMode 枚举提供了多种策略：
- ROUND_HALF_UP (四舍五入)：最常用的模式。例如 1.5 变为 2，1.4 变为 1。
- ROUND_DOWN (向零舍入)：直接截断。例如 1.9 变为 1，-1.9 变为 -1。
- ROUND_UP (远离零舍入)：只要有非零余数就进位。
- ROUND_CEILING (向正无穷)：正数向上取整，负数向零取整。
- ROUND_FLOOR (向负无穷)：正数向零取整，负数向下取整。
- ROUND_HALF_DOWN (五舍六入)：只有大于 0.5 时才进位，等于 0.5 时舍去。
- ROUND_HALF_EVEN (银行家舍入)：向最近的偶数舍入，常用于金融统计以减少累积误差。
设置小数位数 (setScale)
BigDecimal num = new BigDecimal("123.456");
// 保留 2 位小数，四舍五入
BigDecimal scaled = num.setScale(2, RoundingMode.HALF_UP); // 结果：123.46四、 比较大小：equals vs compareTo
这是 BigDecimal 使用中最容易踩的坑之一。
-
equals() ：不仅比较数值大小，还比较精度（scale）。
1.0和1.00在数值上相等，但精度不同。 -
compareTo()：只比较数值大小，忽略精度。这是业务逻辑中判断金额是否相等的正确方式。
BigDecimal x = new BigDecimal("1.0");
BigDecimal y = new BigDecimal("1.00");// 结果为 false，因为精度不同
boolean isEqual = x.equals(y);// 结果为 0，表示数值相等
int result = x.compareTo(y);
if (result == 0) {
System.out.println("金额相等");
}
五、 实战案例：电商订单计算
以下是一个模拟电商订单金额计算的工具类示例，展示了如何安全地进行价格、数量和折扣的计算。
import java.math.BigDecimal;
import java.math.RoundingMode;
public class OrderCalculator {
// 计算订单总价：(单价 * 数量) - 优惠金额
public static BigDecimal calculateTotal(BigDecimal price, int quantity, BigDecimal discount) {
// 1. 将 int 转为 BigDecimal
BigDecimal qty = new BigDecimal(quantity);
// 2. 乘法：单价 * 数量
BigDecimal subTotal = price.multiply(qty);
// 3. 减法：减去优惠
BigDecimal finalTotal = subTotal.subtract(discount);
// 4. 确保结果非负且保留 2 位小数
if (finalTotal.compareTo(BigDecimal.ZERO) < 0) {
finalTotal = BigDecimal.ZERO;
}
return finalTotal.setScale(2, RoundingMode.HALF_UP);
}
public static void main(String[] args) {
BigDecimal price = new BigDecimal("19.99");
int qty = 3;
BigDecimal discount = new BigDecimal("10.00");
BigDecimal total = calculateTotal(price, qty, discount);
System.out.println("最终应付金额: " + total); // 输出: 49.97
}
}六、 常见"坑"与最佳实践
-
空指针异常 (NullPointerException)
在进行运算（如
add,subtract）时，如果参数为null，会抛出空指针异常。务必在运算前进行判空处理。 -
除数为零
如果除数为
BigDecimal.ZERO，会抛出ArithmeticException。建议在除法前校验除数。 -
性能优化
由于
BigDecimal是不可变对象，频繁运算会产生大量临时对象，增加 GC 压力。- 建议：在循环外定义常量，尽量复用对象。
- 建议：在极高并发或性能敏感场景，可考虑将金额转换为"分"（Long 类型）进行计算，最后再转回元。
-
字符串输出
toString()：可能使用科学计数法（如1E+11）。toPlainString()：不使用科学计数法，直接输出完整数字字符串（如100000000000），通常用于前端展示。
掌握以上要点，你就能在 Java 项目中游刃有余地处理高精度数值计算了。