Java BigDecimal 精確計算完全指南：構造器陷阱、運算規則與整數判斷

前言

浮點數 float/double 因二進制無法精確表示十進制小數（如 0.1），導致金融、計量等領域計算誤差。BigDecimal 以「不可變、任意精度、十進制」特性成為精確計算標準工具。本文系統講解構造器選擇、運算不可變性、標度機制及常見工具方法。

一、核心概念：非標度值與標度

BigDecimal 內部由兩部分組成：

• 非標度值：任意精度整數（BigInteger）。
• 標度：32 位整數。
  • 標度 ≥ 0：小數點右側位數。例：13.412 → 非標度值 13412，標度 3。
  • 標度 < 0：非標度值乘以 10^-scale。例：12000 標度 -3 → 12000 × 10³ = 12,000,000。

數值 = unscaledValue × 10-scale。

二、構造器選擇：字符串構造器 vs double 構造器

2.1 經典陷阱

new BigDecimal(1.22)  // 輸出 1.2199999999999999733546474089962430298328399658203125
new BigDecimal("1.22") // 輸出 1.22

原因：double 二進制近似值直接傳入，BigDecimal 忠實保存該近似值；字符串構造器解析十進制字面量，精確無誤。

2.2 官方建議

1. 優先 new BigDecimal(String)。
2. 若源頭是 double，用 BigDecimal.valueOf(double)（內部調用 Double.toString 再解析）或 new BigDecimal(String.valueOf(double))。
3. 避免直接 new BigDecimal(double)。

三、運算不可變性：每步運算產生新對象

BigDecimal a = new BigDecimal("1.22");
BigDecimal b = new BigDecimal("2.22");
a.add(b);           // 返回新對象 3.44，a 仍為 1.22
a = a.add(b);       // 正確：接收返回值

鐵律：所有算術方法（add/subtract/multiply/divide）均返回新 BigDecimal，原對象不變。切記賦值接收！

四、除法與精度控制

// 無限循環小數必須指定精度與舍入模式
a.divide(b, 10, RoundingMode.HALF_UP)  // 保留 10 位，四捨五入
// 或使用 MathContext
a.divide(b, new MathContext(10, RoundingMode.HALF_UP))

常用舍入模式：HALF_UP（四捨五入）、HALF_EVEN（銀行家舍入）、DOWN（截斷）、UP（遠離零）。

五、實用工具方法

六、判斷是否為整數

private boolean isIntegerValue(BigDecimal bd) {
    return bd.signum() == 0 
        || bd.scale() <= 0 
        || bd.stripTrailingZeros().scale() <= 0;
}

邏輯：
1. 值為 0 → 整數。
2. 標度 ≤ 0 → 無小數位或科學記數法表示整數。
3. 去尾部零後標度 ≤ 0 → 如 10.00 去零後 1E1 標度 -1，屬整數。

七、性能與最佳實踐

1. 復用常量：定義 static final BigDecimal ZERO = BigDecimal.ZERO 等，避免重複創建。
2. 避免循環 new：循環內運算優先用局部變量累積，最後一次性賦值。
3. 大數據量考慮：極高性能場景可考慮 long 定點數（乘 100/10000 存分/厘），但維護成本高。
4. 序列化：BigDecimal 實現 Serializable，但建議存儲為字符串或 scale + unscaledValue 兩字段，避免跨版本反序列化問題。

八、總結

• 字符串構造器是精確計算的起點。
• 不可變性意味著鏈式調用必須接收返回值。
• 標度機制賦予科學記數法表示能力，stripTrailingZeros 是判斷整數關鍵。
• 除法必須指定精度與舍入，否則拋 ArithmeticException。

掌握 BigDecimal，讓金額計算告別「少一分、多一分」的尷尬。