Java 源文件類定義規則詳解：一個 .java 文件能包含幾個類？

核心結論

一個 .java 源文件最多只能包含一個 public 級別的頂層類（頂層類指非內部類），且該類的類名必須與文件名完全一致。 除此之外，文件中可以包含任意數量的非 public 類（默認包訪問權限）、內部類、嵌套類、枚舉、介面等。

規則詳解與代碼示例

✅ 合法情況

// File: Main.java
public class Main { }           // 唯一的 public 頂層類，文件名匹配

class Helper { }                // 包私有類，無數量限制
class Util { }                  // 另一個包私有類

// 內部類、嵌套類、枚舉、介面均不受限制
class Outer {
    class Inner { }
    static class Nested { }
}
enum Status { OK, FAIL }
interface Callback { void run(); }

❌ 非法情況

// File: Main.java
public class Main { }
public class Another { }  // 編譯錯誤：The public type Another must be defined in its own file

為什麼要這樣設計？

1. 編譯器定位機制：`javac` 根據文件名快速定位 public 類，無需掃描全文件
2. 類加載器約定：類加載器期望 `com.pkg.ClassName` 對應 `com/pkg/ClassName.class`
3. 模塊化與可維護性：強制一類一檔，降低耦合，便於版本控制與團隊協作

實際開發中的最佳實踐

常見誤區澄清

• 誤區：「一個文件只能有一個類」—— 錯誤，只限制 public 頂層類
• 誤區：「內部類算在限制內」—— 錯誤，內部類不受此限制
• 誤區：「default 類不能被外部訪問」—— 同包下完全可訪問

總結

記住鐵律：一個 .java 文件 = 至多一個 public 頂層類 + 文件名必須匹配。其他類型（包私有類、內部類、枚舉、介面）隨意放。遵循「高內聚、低耦合」原則，該拆文件時果斷拆分，代碼結構會更清晰、編譯更快、維護更易。