BigDecimal 解决 Java 浮点精度问题
在 Java 中,float 和 double 类型因底层采用二进制浮点数存储,无法精确表示部分十进制小数(如 0.1),导致数值计算时出现精度丢失问题。java.math.BigDecimal 类专为高精度十进制运算设计,能完美解决该问题。
Java float/double 存在二进制精度丢失问题,BigDecimal 通过整数加标度实现高精度十进制运算。文章阐述其原理、正确创建方式(String/valueOf)、核心运算方法(需指定舍入模式)、比较规则(compareTo vs equals)及格式化技巧。结合金额计算场景提供工具类代码示例,总结常见坑点与最佳实践,确保金融等高精度场景下的数值准确性。
在 Java 中,float 和 double 类型因底层采用二进制浮点数存储,无法精确表示部分十进制小数(如 0.1),导致数值计算时出现精度丢失问题。java.math.BigDecimal 类专为高精度十进制运算设计,能完美解决该问题。
float/ 会丢失精度?double计算机底层以二进制存储浮点数,而部分十进制小数(如 0.1、0.2)转换为二进制时是无限循环小数。由于 float(32 位)和 double(64 位)的存储位数有限,只能截取近似值存储,导致计算时出现精度偏差。
public class FloatPrecisionDemo {
public static void main(String[] args) {
System.out.println(0.1 + 0.2); // 输出 0.30000000000000004(预期 0.3)
System.out.println(1.0 - 0.9); // 输出 0.09999999999999998(预期 0.1)
System.out.println(0.1 * 3); // 输出 0.30000000000000004(预期 0.3)
System.out.println(1.0 / 3); // 输出 0.3333333333333333(无限近似值)
}
}
在金融计算(金额、税率)、科学计算等场景中,精度丢失会导致严重问题(如金额计算错误、数据偏差),因此必须使用高精度计算类 BigDecimal。
integerDigits + scale)的形式存储,避免二进制转换带来的精度损失;BigDecimal 对象创建后无法修改,所有运算都会返回新的 BigDecimal 对象。核心原则:避免使用 BigDecimal(double) 构造方法(会继承 double 的精度偏差),优先使用以下两种方式:
| 创建方式 | 适用场景 | 示例代码 | 说明 |
|---|---|---|---|
BigDecimal(String) | 已知精确十进制字符串 | new BigDecimal("0.1") | 最推荐,无精度损失 |
BigDecimal.valueOf(double) | 需转换 double 类型 | BigDecimal.valueOf(0.1) | 底层通过 Double.toString() 转字符串,避免偏差 |
BigDecimal(double) | 不推荐(除非明确接受偏差) | new BigDecimal(0.1) | 会存储 0.1 的二进制近似值,存在精度损失 |
public class BigDecimalCreateDemo {
public static void main(String[] args) {
// 错误方式:BigDecimal(double) 存在精度损失
BigDecimal wrong1 = new BigDecimal(0.1);
System.out.println(wrong1); // 输出 0.1000000000000000055511151231257827021181583404541015625
// 正确方式 1:BigDecimal(String)
BigDecimal correct1 = new BigDecimal("0.1");
System.out.println(correct1); // 输出 0.1(精确)
// 正确方式 2:BigDecimal.valueOf(double)
BigDecimal correct2 = BigDecimal.valueOf(0.1);
System.out.println(correct2); // 输出 0.1(精确)
}
}
BigDecimal 没有重载 +、-、*、/ 运算符,需通过实例方法完成运算,且除法运算必须指定舍入模式(避免除不尽时抛出异常)。
| 运算类型 | 方法签名 | 示例(a 和 b 为 BigDecimal) |
|---|---|---|
| 加法 | add(BigDecimal augend) | a.add(b) → 等价于 a + b |
| 减法 | subtract(BigDecimal subtrahend) | a.subtract(b) → 等价于 a - b |
| 乘法 | multiply(BigDecimal multiplicand) | a.multiply(b) → 等价于 a * b |
| 除法 | divide(BigDecimal divisor, RoundingMode mode) | a.divide(b, RoundingMode.HALF_UP) → 等价于 a / b(四舍五入) |
| 除法(指定精度) | divide(BigDecimal divisor, int scale, RoundingMode mode) | a.divide(b, 2, RoundingMode.HALF_UP) → 保留 2 位小数,四舍五入 |
import java.math.BigDecimal;
import java.math.RoundingMode;
public class BigDecimalCalcDemo {
public static void main(String[] args) {
// 1. 初始化精确数值
BigDecimal a = new BigDecimal("0.1");
BigDecimal b = new BigDecimal("0.2");
BigDecimal c = new BigDecimal("3");
// 2. 加法
BigDecimal sum = a.add(b);
System.out.println("0.1 + 0.2 = " + sum); // 输出 0.3(精确)
// 3. 减法
BigDecimal diff = new BigDecimal("1.0").subtract(new BigDecimal("0.9"));
System.out.println("1.0 - 0.9 = " + diff); // 输出 0.1(精确)
// 4. 乘法
BigDecimal product = a.multiply(c);
System.out.println("0.1 * 3 = " + product); // 输出 0.3(精确)
// 5. 除法(除不尽时必须指定舍入模式)
BigDecimal divide1 = new BigDecimal("1.0").divide(c, RoundingMode.HALF_UP);
System.out.println("1.0 / 3 = " + divide1); // 输出 0.33333333333333333333(默认精度)
// 6. 除法(指定小数位数和舍入模式)
BigDecimal divide2 = new BigDecimal("1.0").divide(c, 2, RoundingMode.HALF_UP);
System.out.println("1.0 / 3(保留 2 位) = " + divide2); // 输出 0.33(四舍五入)
}
}
BigDecimal 提供 RoundingMode 枚举类定义取舍规则,常用场景(如金额计算)优先使用 HALF_UP(四舍五入),避免使用默认的 UNNECESSARY(除不尽时抛异常)。
| 舍入模式 | 中文含义 | 示例(保留 2 位小数) | 适用场景 |
|---|---|---|---|
RoundingMode.HALF_UP | 四舍五入 | 1.235 → 1.24 | 金额、常规计算 |
RoundingMode.HALF_DOWN | 五舍六入 | 1.235 → 1.23 | 特定精度要求场景 |
RoundingMode.UP | 向上取整(进一) | 1.231 → 1.24 | 需高估结果(如税费) |
RoundingMode.DOWN | 向下取整(去尾) | 1.239 → 1.23 | 需低估结果(如库存) |
RoundingMode.CEILING | 向正无穷取整 | 1.23 → 1.24;-1.23 → -1.23 | 正数向上、负数向下 |
RoundingMode.FLOOR | 向负无穷取整 | 1.23 → 1.23;-1.23 → -1.24 | 正数向下、负数向上 |
RoundingMode.UNNECESSARY | 无需舍入(抛异常) | 1.235 → 抛 ArithmeticException | 确保结果无余数的场景 |
通过 setScale(int scale, RoundingMode mode) 手动设置小数位数,结合 DecimalFormat 格式化输出(如金额千分位、货币符号)。
import java.math.BigDecimal;
import java.math.RoundingMode;
import java.text.DecimalFormat;
public class BigDecimalFormatDemo {
public static void main(String[] args) {
BigDecimal amount = new BigDecimal("12345.6789");
// 1. 设置小数位数(保留 2 位,四舍五入)
BigDecimal scaledAmount = amount.setScale(2, RoundingMode.HALF_UP);
System.out.println("保留 2 位小数:" + scaledAmount); // 输出 12345.68
// 2. 格式化输出(千分位、货币符号)
DecimalFormat df = new DecimalFormat("###,###.00"); // 保留 2 位小数,千分位分隔
String formatted = df.format(scaledAmount);
System.out.println("格式化金额:" + formatted); // 输出 12,345.68
// 3. 格式化货币(如人民币)
DecimalFormat currencyDf = new DecimalFormat("¥###,###.00");
System.out.println("货币格式:" + currencyDf.format(scaledAmount)); // 输出 ¥12,345.68
}
}
==)BigDecimal 是对象,== 比较的是内存地址,需使用 compareTo(BigDecimal val) 方法比较数值大小:
0:两数相等;1:当前数大于参数;-1:当前数小于参数。import java.math.BigDecimal;
public class BigDecimalCompareDemo {
public static void main(String[] args) {
BigDecimal x = new BigDecimal("10.00");
BigDecimal y = new BigDecimal("10");
BigDecimal z = new BigDecimal("10.01");
System.out.println(x.equals(y)); // false(equals 比较值和标度,x 标度 2,y 标度 0)
System.out.println(x.compareTo(y) == 0); // true(compareTo 仅比较数值)
System.out.println(x.compareTo(z) < 0); // true(x < z)
System.out.println(z.compareTo(x) > 0); // true(z > x)
}
}
通过 xxxValue() 方法将 BigDecimal 转换为基本类型(需注意数值范围,避免溢出):
BigDecimal num = new BigDecimal("123");
int intVal = num.intValue(); // 转换为 int
long longVal = num.longValue(); // 转换为 long
double doubleVal = num.doubleValue(); // 转换为 double(大数值可能丢失精度)
BigDecimal(double) 构造器如前文所述,new BigDecimal(0.1) 会存储 0.1 的二进制近似值,导致精度丢失,必须使用字符串或 valueOf(double) 构造。
当除法运算结果无法整除时(如 1.0 / 3),若未指定舍入模式,会抛出 ArithmeticException:
// 错误:未指定舍入模式,抛异常
// BigDecimal wrong = new BigDecimal("1.0").divide(new BigDecimal("3"));
// 正确:指定舍入模式
BigDecimal correct = new BigDecimal("1.0").divide(new BigDecimal("3"), RoundingMode.HALF_UP);
equals() 与 compareTo() 的区别equals():比较数值 + 标度(如 10.00 和 10 不相等);compareTo():仅比较数值(如 10.00 和 10 相等)。最佳实践:比较数值大小时用 compareTo(),判断是否完全相等(含标度)时用 equals()。
BigDecimal 是不可变对象,每次运算都会创建新对象,频繁运算(如循环累加)会产生大量临时对象,影响性能。解决方案:
MutableBigDecimal);BigDecimal 的精度优势优先于性能损耗)。BigDecimal 是引用类型,可能为 null,运算前需做非空判断:
// 推荐:非空判断(避免空指针异常)
public static BigDecimal add(BigDecimal a, BigDecimal b) {
a = a == null ? BigDecimal.ZERO : a;
b = b == null ? BigDecimal.ZERO : b;
return a.add(b);
}
BigDecimal(String) 或 BigDecimal.valueOf(double),禁止使用 BigDecimal(double);RoundingMode.HALF_UP),复杂运算指定小数位数;compareTo() 而非 == 或 equals()(除非需比较标度);DecimalFormat 统一格式,避免直接 toString();BigDecimal 时,需做非空判断,默认值用 BigDecimal.ZERO;BigDecimal;普通场景(无精度要求)可使用 double 提升性能。import java.math.BigDecimal;
import java.math.RoundingMode;
/**
* 金额计算工具类(示例)
*/
public class MoneyUtils {
// 小数位数(默认 2 位,对应分)
private static final int SCALE = 2;
// 舍入模式(四舍五入)
private static final RoundingMode ROUND_MODE = RoundingMode.HALF_UP;
// 加法
public static BigDecimal add(BigDecimal a, BigDecimal b) {
a = a == null ? BigDecimal.ZERO : a;
b = b == null ? BigDecimal.ZERO : b;
return a.add(b).setScale(SCALE, ROUND_MODE);
}
// 减法
public static BigDecimal subtract(BigDecimal a, BigDecimal b) {
a = a == null ? BigDecimal.ZERO : a;
b = b == null ? BigDecimal.ZERO : b;
return a.subtract(b).setScale(SCALE, ROUND_MODE);
}
// 乘法(如金额 × 税率)
public static BigDecimal multiply(BigDecimal amount, BigDecimal rate) {
amount = amount == null ? BigDecimal.ZERO : amount;
rate = rate == null ? BigDecimal.ZERO : rate;
return amount.multiply(rate).setScale(SCALE, ROUND_MODE);
}
// 除法(如金额 ÷ 数量)
public static BigDecimal divide(BigDecimal amount, BigDecimal count) {
amount = amount == null ? BigDecimal.ZERO : amount;
count = count == null ? BigDecimal.ONE : count;
return amount.divide(count, SCALE, ROUND_MODE);
}
public static void main(String[] args) {
BigDecimal price = new BigDecimal("99.99"); // 单价
BigDecimal count = new BigDecimal("3"); // 数量
BigDecimal rate = new BigDecimal("0.06"); // 税率 6%
BigDecimal total = multiply(price, count); // 总价:99.99 × 3 = 299.97
BigDecimal tax = multiply(total, rate); // 税费:299.97 × 0.06 = 17.9982 → 18.00
BigDecimal finalAmount = add(total, tax); // 最终金额:299.97 + 18.00 = 317.97
System.out.println("总价:" + total); // 输出 299.97
System.out.println("税费:" + tax); // 输出 18.00
System.out.println("最终金额:" + finalAmount); // 输出 317.97
}
}
通过 BigDecimal 可彻底解决浮点精度问题,尤其适用于对精度要求极高的场景。掌握其核心用法和最佳实践,能有效避免常见错误,确保计算结果的准确性。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online