Java Static Import 靜態導入用法與最佳實踐

什麼是 Static Import？

JDK 5 引入的語法糖，允許直接導入類的 靜態成員（靜態方法、靜態常數），使用時可省略類名限定。

基本語法

// 導入單一靜態成員
import static java.lang.Math.PI;
import static java.lang.System.out;

// 導入該類所有靜態成員（慎用）
import static java.lang.Math.*;
import static java.util.stream.Collectors.*;

前後對比

傳統寫法

public class Circle {
    public static void main(String[] args) {
        double r = 5;
        System.out.println("圓周長：" + (2 * Math.PI * r));
        System.out.println("圓面積：" + (Math.PI * Math.pow(r, 2)));
    }
}

Static Import 寫法

import static java.lang.Math.PI;
import static java.lang.Math.pow;
import static java.lang.System.out;

public class Circle {
    public static void main(String[] args) {
        double r = 5;
        out.println("圓周長：" + (2 * PI * r));
        out.println("圓面積：" + (PI * pow(r, 2)));
    }
}

適用場景

• 常數密集運算：數學、物理常數（Math.PI, Integer.MAX_VALUE）。
• 工具方法鏈式調用：Collectors.toList(), Stream.of(), Assert.assertEquals() (JUnit)。
• DSL 風格 API：如 Hamcrest assertThat(actual, is(expected))、Mockito when(mock.method()).thenReturn(value)。

潛在風險與禁忌

1. 命名衝突：兩個類有同名靜態成員（如 Integer.MAX_VALUE vs Long.MAX_VALUE），導入後直接使用會編譯錯誤「reference is ambiguous」。
2. 可讀性下降：大量野生導入 import static pkg.*; 使方法來源不明，維護者需跳轉定義才知來處。
3. 破壞封裝感知：靜態方法看似全域函數，淡化了物件導向的類歸屬關係。

最佳實踐建議

1. 精確導入單一成員：import static java.lang.Math.PI; 而非 import static java.lang.Math.*;。
2. 限制於公認常數/工具類：Math, Collections, Objects, 測試框架斷言類。
3. 避免在業務邏輯類大量使用：保持類名限定，明確語義邊界。
4. 團隊統一規範：在代碼風格指南中明確允許/禁止清單。

總結

Static Import 是雙面刃：用得好能讓數學運算、測試斷言、Stream API 代碼更流暢；濫用則製造維護噩夢。原則：少用、精準用、團隊協議用。