Java BigDecimal 精確計算完整指南：避開浮點數陷阱的最佳實踐

為什麼需要 BigDecimal？

float 和 double 設計用於科學計算，採用二進制浮點運算，無法精確表示許多十進制小數（如 0.1）。商業場景（金額、利率、稅費）要求絕對精確，必須使用 BigDecimal。

// 錯誤示範
double a = 0.1;
double b = 0.2;
System.out.println(a + b); // 輸出：0.30000000000000004

// 正確做法
BigDecimal a = new BigDecimal("0.1");
BigDecimal b = new BigDecimal("0.2");
System.out.println(a.add(b)); // 輸出：0.3

BigDecimal 核心結構

BigDecimal = unscaledValue × 10^(-scale)

• unscaledValue：任意精度整數（BigInteger）
• scale：32位整數，表示小數點後位數（正數）；負數表示乘以 10 的冪次

構造方法選擇：String vs double

核心原則：永遠使用 String 構造方法或 valueOf(double)，絕不直接使用 double 構造器。

不可變性：最容易踩的坑

BigDecimal 是不可變的，所有運算方法都返回新對象：

BigDecimal a = new BigDecimal("1.22");
BigDecimal b = new BigDecimal("2.22");

// ❌ 錯誤：a 不會改變
a.add(b);
System.out.println(a); // 仍輸出 1.22

// ✅ 正確：必須接收返回值
BigDecimal result = a.add(b);
System.out.println(result); // 3.44

// 或鏈式調用
a = a.add(b).multiply(new BigDecimal("2"));

核心運算方法

除法必須指定精度與舍入模式

// ❌ 會拋出 ArithmeticException: Non-terminating decimal expansion
BigDecimal result = a.divide(b);

// ✅ 必須指定保留小數位和舍入模式
BigDecimal result = a.divide(b, 2, RoundingMode.HALF_UP); // 保留2位，四捨五入
BigDecimal result = a.divide(b, 10, RoundingMode.HALF_EVEN); // 銀行家算法

RoundingMode 舍入模式詳解

比較大小：只用 compareTo

// ❌ 錯誤：equals 比較值和 scale，1.0 != 1.00
a.equals(b); 

// ✅ 正確：compareTo 只比較數值大小
int cmp = a.compareTo(b);
// cmp < 0: a < b
// cmp == 0: a == b
// cmp > 0: a > b

源碼洞察：add 方法為什麼返回新對象？

簡化版 add 邏輯：

public BigDecimal add(BigDecimal augend) {
    // 1. 對齊小數位（scale 取大的）
    // 2. 整數值相加（intCompact 或 BigInteger）
    // 3. 檢查溢出
    // 4. 返回 new BigDecimal(sum, newScale)  // 新對象！
}

這就是為什麼必須接收返回值的根本原因。

最佳實踐總結

1. 構造：優先 new BigDecimal("str")，次選 BigDecimal.valueOf(double)
2. 運算：必須接收返回值，鏈式調用或重新賦值
3. 除法：必須指定 scale 和 RoundingMode
4. 比較：只用 compareTo，不用 equals
5. 常量定義：預定義常用常量避免重複創建

   public static final BigDecimal ZERO = BigDecimal.ZERO;
   public static final BigDecimal ONE = BigDecimal.ONE;
   public static final BigDecimal HUNDRED = new BigDecimal("100");

6. 數據庫交互：MyBatis/JPA 映射 DECIMAL 類型字段直接用 BigDecimal

性能優化建議

• 避免循環中重複創建 BigDecimal，提取為常量
• 大量計算場景考慮 long 儲存分/厘，展示時除以 100/1000
• 使用 MathContext 限制精度：new BigDecimal(value, MathContext.DECIMAL64)

總結

BigDecimal 是 Java 處理精確計算的利器，核心在於：String 構造、不可變接收返回值、除法指定精度、compareTo 比較。掌握這四點，即可避開 99% 的浮點數陷阱，構建可靠的金融級計算系統。