【Java每日一題】可變參數與方法重載優先級規則解析

【Java每日一題】可變參數與方法重載優先級規則解析

這道經典題目考察 Java 方法重載解析時，固定參數優先於可變參數的核心規則。理解此機制對避免 API 設計歧義、排查「明明有更合適的方法卻未被調用」至關重要。

題目代碼

public class Ques1201 {
    public static void main(String[] args) {
        new Ques1201().sum(1, 2);
    }
    
    public void sum(int num1, int num2) {           // 方法 A：固定雙參數
        int temp = num1 + num2;
        System.out.println("沒使用變長參數計算：" + temp);
    }
    
    public void sum(int num1, int... num2) {        // 方法 B：可變參數
        int temp = num1;
        for (int n : num2) {
            temp = temp + n;
        }
        System.out.println("使用變長參數計算：" + temp);
    }
}

執行結果

沒使用變長參數計算：3

核心規則：Java 重載解析三階段

JLS (Java Language Specification) 定義方法選擇按嚴格順序進行：

1. 第一階段：不使用可變參數、不進行自動裝箱/拆箱
   精確匹配參數類型與個數。sum(int, int) 完美匹配 sum(1, 2)，直接選中 方法 A。
2. 第二階段：允許自動裝箱/拆箱，但不使用可變參數
   若第一階段無匹配，嘗試裝箱/拆箱轉換（如 int ↔ Integer）。
3. 第三階段：允許可變參數
   前兩階段均無匹配時，才考慮可變參數方法。sum(int, int...) 屬於此階段。

驗證實驗：改變調用方式觀察差異

設計最佳實務

1. 避免固定參數與可變參數重載衝突：若業務允許，統一使用可變參數 sum(int... nums)
2. API 公開時文檔標註優先級：明確告知調用方「傳兩個 int 會調用固定參數版本」
3. 測試覆蓋邊界調用：單元測試需覆蓋 0、1、2、N 參數場景
4. Java 8+ 考慮 Stream API：IntStream.of(nums).sum() 替代手寫求和

進階陷阱：可變參數與陣列的微妙關係

void foo(int... nums) {}
void foo(int[] nums) {}  // 編譯錯誤：擦除後簽名相同

// 但調用時：
foo(1, 2, 3);        // 調用可變參數版本
foo(new int[]{1,2}); // 調用陣列版本 (若單獨存在)
foo((int[]) null);   // 調用陣列版本
foo(null);           // 編譯歧義錯誤

總結

Java 重載解析的「固定參數優先於可變參數」規則，體現了語言設計者對向後相容性與最小驚訝原則的堅持：早期代碼無可變參數概念，引入可變參數時必須確保舊調用行為不變。掌握三階段解析機制，是 Java 開發者從「能用」進階到「精通」的關鍵門檻之一。