目录
[一、为什么需要 BigDecimal?](#一、为什么需要 BigDecimal?)
[二、BigDecimal 的创建方式](#二、BigDecimal 的创建方式)
[1. 使用字符串创建(推荐)](#1. 使用字符串创建(推荐))
[2. 使用 valueOf() 创建(推荐)](#2. 使用 valueOf() 创建(推荐))
[3. 直接传入 double(不推荐)](#3. 直接传入 double(不推荐))
[三、BigDecimal 常用运算方法](#三、BigDecimal 常用运算方法)
[1. 加法 add()](#1. 加法 add())
[2. 减法 subtract()](#2. 减法 subtract())
[3. 乘法 multiply()](#3. 乘法 multiply())
[4. 除法 divide()](#4. 除法 divide())
[四、BigDecimal 的舍入规则](#四、BigDecimal 的舍入规则)
[五、BigDecimal 比较大小](#五、BigDecimal 比较大小)
[1. equals() 比较](#1. equals() 比较)
[2. compareTo() 比较(推荐用于数值比较)](#2. compareTo() 比较(推荐用于数值比较))
[六、BigDecimal 是不可变对象](#六、BigDecimal 是不可变对象)
[七、BigDecimal 练习:模拟电商订单金额计算](#七、BigDecimal 练习:模拟电商订单金额计算)
[八、BigDecimal 常见注意事项](#八、BigDecimal 常见注意事项)

一、为什么需要 BigDecimal?
在 Java 中,float 和 double 用于表示浮点数,但由于计算机采用二进制存储浮点数,部分十进制小数无法被精确表示,因此可能产生精度问题。
示例:
java
public class Main {
public static void main(String[] args) {
System.out.println(0.1 + 0.2);
}
}
输出:
java
0.30000000000000004
预期结果是 0.3,实际却存在精度误差。
在普通业务中,这种误差可能影响不大,但在如下场景中需要格外注意:
-
金融系统:金额、利息、手续费计算
-
电商系统:商品价格、订单总额、优惠金额
-
财务系统:税率、成本、利润计算
因此, BigDecimal****类就派上用场了,用于进行高精度十进制数值运算。
二、BigDecimal 的创建方式
BigDecimal 位于 java.math 包中。
java
import java.math.BigDecimal;
1. 使用字符串创建(推荐)
java
BigDecimal a = new BigDecimal("0.1");
BigDecimal b = new BigDecimal("0.2");
System.out.println(a.add(b)); // 0.3
使用字符串构造可以准确表示指定的十进制数。
2. 使用 valueOf() 创建(推荐)
java
BigDecimal a = BigDecimal.valueOf(0.1);
BigDecimal b = BigDecimal.valueOf(0.2);
System.out.println(a.add(b)); // 0.3
valueOf(double) 通过 Double.toString() 得到的十进制表示创建对象,适合直接传入十进制浮点字面量。
注意:如果传入的 double 已经经过不精确的浮点计算,valueOf() 不能自动修复之前产生的误差。
3. 直接传入 double(不推荐)
java
BigDecimal a = new BigDecimal(0.1);
System.out.println(a);
输出:
java
0.1000000000000000055511151231257827021181583404541015625
原因:new BigDecimal(double) 会精确保存传入 double 的实际二进制浮点值,而这个值可能不是预期的十进制小数。
结论:优先使用 new BigDecimal("0.1")或 **BigDecimal.valueOf(0.1)**。
三、BigDecimal 常用运算方法
BigDecimal 不使用普通的 +、-、*、/ 运算符进行对象数值运算,而是通过方法完成计算。
| 方法 | 作用 |
|---|---|
add() |
加法 |
subtract() |
减法 |
multiply() |
乘法 |
divide() |
除法 |
setScale() |
设置小数位数及舍入规则 |
compareTo() |
比较数值大小 |
equals() |
比较数值和精度(scale) |
1. 加法 add()
java
BigDecimal a = new BigDecimal("10.5");
BigDecimal b = new BigDecimal("2.0");
System.out.println(a.add(b)); // 12.5
2. 减法 subtract()
java
System.out.println(a.subtract(b)); // 8.5
3. 乘法 multiply()
java
System.out.println(a.multiply(b)); // 21.00
4. 除法 divide()
java
BigDecimal a = new BigDecimal("10");
BigDecimal b = new BigDecimal("4");
System.out.println(a.divide(b)); // 2.5
注意:当除法结果是无限循环小数时,直接使用 divide()可能抛出 ArithmeticException。
例如:
java
BigDecimal a = new BigDecimal("10");
BigDecimal b = new BigDecimal("3");
// 可能抛出 ArithmeticException
System.out.println(a.divide(b));
正确做法是指定小数位数和舍入规则:
java
System.out.println(
a.divide(b, 2, RoundingMode.HALF_UP)
);
// 3.33
其中:
-
2:保留两位小数 -
RoundingMode.HALF_UP:常见的四舍五入模式
需要导入:
java
import java.math.RoundingMode;
四、BigDecimal 的舍入规则
在金额计算中,经常需要保留两位小数。
java
BigDecimal price = new BigDecimal("12.345");
BigDecimal result = price.setScale(
2,
RoundingMode.HALF_UP
);
System.out.println(result); // 12.35
常用舍入模式:
| 舍入模式 | 含义 |
|---|---|
HALF_UP |
常见四舍五入,恰好一半时向远离零的方向舍入 |
HALF_EVEN |
银行家舍入法,恰好一半时向最接近的偶数舍入 |
DOWN |
直接舍弃多余小数,向零方向截断 |
UP |
存在被舍弃的非零数字时,向远离零的方向舍入 |
CEILING |
向正无穷方向舍入 |
FLOOR |
向负无穷方向舍入 |
例如:
java
BigDecimal num = new BigDecimal("12.345");
System.out.println(
num.setScale(2, RoundingMode.HALF_UP)
); // 12.35
System.out.println(
num.setScale(2, RoundingMode.DOWN)
); // 12.34
注意:实际金融业务应采用明确的业务舍入规则,不能所有场景都默认使用 HALF_UP。
五、BigDecimal 比较大小
1. equals() 比较
BigDecimal a = new BigDecimal("1.0");
BigDecimal b = new BigDecimal("1.00");
System.out.println(a.equals(b)); // false
原因:equals() 不仅比较数值,还会比较 scale(小数精度)。
虽然 1.0 和 1.00 数值相同,但它们的 scale 分别为 1 和 2。
2. compareTo() 比较(推荐用于数值比较)
java
BigDecimal a = new BigDecimal("1.0");
BigDecimal b = new BigDecimal("1.00");
System.out.println(a.compareTo(b)); // 0
compareTo() 返回值:
-
大于
0:a 大于 b -
等于
0:a 与 b 数值相等 -
小于
0:a 小于 b
实际业务中,如果只需要判断两个 BigDecimal 的数值是否相等,通常使用 compareTo() == 0**。**
例如:
java
if (a.compareTo(b) == 0) {
System.out.println("金额相等");
}
六、BigDecimal 是不可变对象
BigDecimal 和 String 类似,属于不可变对象。
调用运算方法后,不会修改原对象,而是返回一个新的 BigDecimal 对象。
错误示例:
java
BigDecimal a = new BigDecimal("10");
BigDecimal b = new BigDecimal("5");
a.add(b);
System.out.println(a); // 10
正确示例:
java
BigDecimal a = new BigDecimal("10");
BigDecimal b = new BigDecimal("5");
a = a.add(b);
System.out.println(a); // 15
重点:BigDecimal 运算之后,需要接收返回结果。
七、BigDecimal 练习:模拟电商订单金额计算
假设用户购买 3 件商品:
-
商品单价:19.90 元
-
商品数量:3 件
-
优惠折扣:85 折
要求:计算商品总价和最终支付金额。
java
import java.math.BigDecimal;
import java.math.RoundingMode;
public class OrderDemo {
public static void main(String[] args) {
// 商品单价
BigDecimal price = new BigDecimal("19.90");
// 商品数量
BigDecimal quantity = BigDecimal.valueOf(3);
// 折扣系数:85折
BigDecimal discount = new BigDecimal("0.85");
// 计算原价
BigDecimal total = price.multiply(quantity);
// 计算折扣后的金额
BigDecimal actualPrice = total
.multiply(discount)
.setScale(2, RoundingMode.HALF_UP);
System.out.println("订单原价:" + total);
System.out.println("实付金额:" + actualPrice);
}
}
运行结果:
java
订单原价:59.70
实付金额:50.75
计算过程:
java
19.90 × 3 = 59.70
59.70 × 0.85 = 50.745
保留两位小数:50.75
八、BigDecimal 常见注意事项
1. 不推荐使用 new BigDecimal(double)
java
// 不推荐
new BigDecimal(0.1);
// 推荐
new BigDecimal("0.1");
BigDecimal.valueOf(0.1);
2. 除法需要注意无限循环小数
java
BigDecimal result = a.divide(
b,
2,
RoundingMode.HALF_UP
);
3. 比较数值时优先使用 compareTo()
java
a.compareTo(b) == 0 // 数值相等
a.compareTo(b) > 0 // a 大于 b
a.compareTo(b) < 0 // a 小于 b
4. 运算结果需要重新赋值
java
a = a.add(b);
5. 可以使用预定义常量
java
BigDecimal.ZERO; // 0
BigDecimal.ONE; // 1
BigDecimal.TEN; // 10
6. 不建议在金额计算的中间过程随意转为 double
double money = a.doubleValue();
因为转换为 double 可能再次引入浮点精度误差。
九、总结
| 核心知识 | 重点 |
|---|---|
| 创建对象 | new BigDecimal(String)、valueOf() |
| 加法 | add() |
| 减法 | subtract() |
| 乘法 | multiply() |
| 除法 | divide() |
| 小数位数 | setScale() |
| 舍入模式 | RoundingMode |
| 数值比较 | compareTo() |
| 对象特点 | 不可变对象 |
总结:涉及金额等精确十进制计算时,优先考虑 BigDecimal;创建时避免直接传入 double,运算后记得接收返回值,除法和小数处理时明确舍入规则。