Java 內部類全解析：四大類型、訪問規則、編譯產物與使用建議

內部類定義與分類

在類內部聲明的類稱為內部類，外部類稱為外部類。按聲明位置和修飾符分四類：

編譯產物命名規則

Outer.class
Outer$Inner.class           // 非靜態成員內部類
Outer$1.class               // 匿名內部類 (按順序編號)
Outer$2$Local.class         // 局部內部類 (方法內編號$類名)
Outer$StaticNested.class    // 靜態嵌套類

每個內部類編譯為獨立 .class 文件。

核心訪問規則詳解

1. 非靜態成員內部類

• 持有外部類引用：Outer.this 隱式字段，構造器自動綁定。
• 可直接訪問外部類所有成員（含 private）。
• 外部類訪問內部類需創建實例：Inner in = new Inner(); in.method();
• 外部類靜態方法中無法直接實例化非靜態內部類（無 this）。

2. 靜態嵌套類

• 無 Outer.this 引用，獨立於外部類實例。
• 僅能訪問外部類 static 成員。
• 本質是頂層類，只是命名空間嵌套，推薦優先使用。

3. 局部內部類

• 作用域限於聲明它的塊（方法、構造器、初始化塊）。
• JDK 8+ 可訪問「實際上 final」的局部變量（無需顯式 final）。
• 不能有 static 成員（枚舉/介面除外）。

4. 匿名內部類

• 語法：new SuperType/Interface() { // 體 }
• 隱式繼承父類/實現介面，常用於事件監聽、線程任務、比較器。
• 無構造器，可用實例初始化塊 { ... } 替代。
• JDK 8+ 函數式介面場景優先用 Lambda 表達式替代。

實戰代碼示例

成員內部類（非靜態）

public class Outer {
    private int outerField = 10;
    private static int staticField = 20;
    
    public class Inner {
        public void access() {
            System.out.println(outerField);   // 直接訪問
            System.out.println(staticField);
            System.out.println(Outer.this.outerField); // 顯式外部引用
        }
    }
    
    public void test() {
        Inner in = new Inner();  // 隱式傳遞 this
        in.access();
    }
}

// 外部創建
Outer outer = new Outer();
Outer.Inner inner = outer.new Inner();
inner.access();

靜態嵌套類（推薦）

public class Outer {
    private static int staticField = 100;
    
    public static class Nested {
        public void print() {
            System.out.println(staticField); // 僅 static
        }
    }
}

// 獨立創建，無需外部實例
Outer.Nested nested = new Outer.Nested();
nested.print();

匿名內部類 vs Lambda

// 匿名內部類 (JDK 7 風格)
button.addActionListener(new ActionListener() {
    @Override public void actionPerformed(ActionEvent e) {
        System.out.println("clicked");
    }
});

// Lambda (JDK 8+，函數式介面單方法)
button.addActionListener(e -> System.out.println("clicked"));

// 複雜邏輯仍需匿名類/具體類
Runnable task = new Runnable() {
    private int counter = 0;  // 狀態字段
    @Override public void run() {
        System.out.println("Run " + ++counter);
    }
};

優缺點權衡與使用建議

優點

• 封裝：隱藏實現細節，僅外部類可見。
• 便利訪問：非靜態內部類零參數訪問外部狀態。
• 回調/監聽：匿名類/Lambda 簡化單方法介面實現。
• 邏輯分組：靜態嵌套類組織相關類（如 Map.Entry、Builder 模式）。

缺點

• 增加複雜度：嵌套層級深時可讀性驟降。
• 內存洩漏風險：非靜態內部類實例隱式持有外部引用，長生命周期內部實例導致外部對象無法 GC（Handler 泄漏經典案例）。
• 序列化陷阱：非靜態內部類序列化會連帶序列化外部對象。
• 構造器注入困難：非靜態內部類難以通過構造器注入依賴。

最佳實踐清單

1. 默認用靜態嵌套類（static class），無需外部實例時首選。
2. 需訪問外部實例狀態 → 非靜態成員內部類，但警惕生命周期。
3. 方法內臨時邏輯 → 局部內部類（極少見）。
4. 單方法介面回調 → Lambda 表達式（JDK 8+）。
5. 需狀態/多方法/非函數式介面 → 具體獨立類或 static 內部類，避免匿名類。
6. Handler/Listener 持有 Activity/Context → 必須用 static 內部類 + WeakReference。
7. Builder 模式 → public static class Builder 靜態嵌套。

同一文件多頂層類（非內部類）

// File: TwoClasses.java
public class TwoClasses { }  // 文件名必須匹配 public 類
class AnotherClass { }       // 包私有，編譯產生 AnotherClass.class

不推薦：難搜索、違反單一職責、構建工具可能報警。堅持「一文件一公共類」。