Java Math 類常用方法速查表與 Random 進階用法

java.lang.Math 提供豐富的數學運算靜態方法，配合 java.util.Random 及 Java 7+ ThreadLocalRandom，可高效解決數值計算、隨機生成等常見需求。本文整理核心 API、陷阱與最佳實踐。

Math 核心方法速查

常見陷阱與注意事項

1. round 返回型別：round(float) → int，round(double) → long，切勿直接賦值給 int 變數導致精度損失。
2. floor/ceil 返回 double：非整數型別，需轉型 (int)Math.floor(x)。
3. 負數取模：Math.floorMod(-3, 2) = 1（Java 8+），與 % 行為不同。
4. 大數精度：Math.pow(10, 20) 產生 double 近似值，精確整數運算請用 BigInteger。
5. NaN 傳播：任何與 NaN 運算結果皆為 NaN，判斷用 Double.isNaN()。

Random 類進階用法

基本用法

Random rand = new Random(); // 種子預設 System.nanoTime()
rand.nextInt();           // 全範圍 int
rand.nextInt(100);        // [0, 100)
rand.nextLong();          // 全範圍 long
rand.nextDouble();        // [0.0, 1.0)
rand.nextFloat();         // [0.0, 1.0f)
rand.nextBoolean();       // true/false
rand.nextGaussian();      // 正態分佈 μ=0, σ=1
byte[] bytes = new byte[16];
rand.nextBytes(bytes);    // 填充隨機位元組

指定種子：可重現序列（測試/除錯專用）

Random rand = new Random(12345L); // 固定種子 → 固定序列
// 生產環境勿用固定種子，否則隨機性完全可預測

ThreadLocalRandom（Java 7+，多執行緒高效能）

// 無需共享實例，每執行緒獨立，無競爭
int val = ThreadLocalRandom.current().nextInt(4, 64); // [4, 64)
long id = ThreadLocalRandom.current().nextLong(1000, 10000);
double rate = ThreadLocalRandom.current().nextDouble(0.0, 1.0);

優勢：避免 Random 共享實例的 CAS 競爭，多執行緒環境下吞吐量顯著提升。

SecureRandom（加密級隨機）

SecureRandom sr = new SecureRandom();
byte[] token = new byte[32];
sr.nextBytes(token); // 產生加密安全的隨機位元組
// 適用：Session ID、API Token、加密金鑰、OAuth state

注意：SecureRandom 初始化較慢（熵收集），高頻調用建議複用實例或使用 ThreadLocal 緩存。

實用工具方法封裝

public final class MathUtils {
    private MathUtils() {}
    
    /** 產生 [min, max] 區間隨機整數（含邊界） */
    public static int randomInt(int min, int max) {
        return ThreadLocalRandom.current().nextInt(min, max + 1);
    }
    
    /** 產生指定長度數字驗證碼 */
    public static String numericCode(int length) {
        ThreadLocalRandom r = ThreadLocalRandom.current();
        StringBuilder sb = new StringBuilder(length);
        for (int i = 0; i < length; i++) sb.append(r.nextInt(10));
        return sb.toString();
    }
    
    /** 保留 n 位小數四捨五入（基於 BigDecimal 避免浮點誤差） */
    public static double round(double val, int scale) {
        return BigDecimal.valueOf(val)
            .setScale(scale, RoundingMode.HALF_UP)
            .doubleValue();
    }
}

總結建議

• 單執行緒簡單隨機：Math.random() 或 new Random()。
• 多執行緒高頻隨機：優先 ThreadLocalRandom。
• 安全敏感場景：SecureRandom。
• 金融/精確計算：BigDecimal，勿用 double + Math.round。
• 需可重現序列（測試）：固定種子 new Random(seed)。