Java 類設計 30 條核心準則：從命名規範到架構決策

一、 命名與基礎規範

1. 命名風格：類名 PascalCase；字段/方法/變量 camelCase；常量 (static final 基本類型) 全大寫下劃線分隔；包名全小寫。
2. 經典類模板：必實現 equals()、hashCode()、toString()、clone() (實現 Cloneable)、實現 Serializable。
3. 內置測試入口：每個類提供 main() 包含單元測試代碼，不刪除，便於回歸與示例。

二、 方法與類粒度設計

4. 單一職責方法：方法短小、功能單一；過長則拆分，促進複用。
5. 雙重視角設計：站在「客戶程序員」角度保證 API 明確；站在「維護者」角度預判變更點並簡化修改。
6. 類要小而專：解決一個具體問題。判斷拆分信號：複雜 switch → 多態；方法涉及差異大操作 → 多類；成員變量特徵差異大 → 多類。

三、 封裝與可見性

7. 極致私有化：默認 private；只暴露必須公開的。公開後即凍結，修改將破壞客戶代碼。多線程下只有 private 字段受保護。
8. 髒代碼隔離：不得已的妥協代碼封裝在類內部，不外洩。
9. 內部類優化耦合：類間高度耦合時考慮內部類改善封裝與維護。

四、 文檔與可維護性

10. 詳盡 Javadoc：細粒度註釋，生成專業文檔，為自己與後人服務。
11. 消除魔術數字：用語義化常量替代字面值（如 ARRAY_SIZE = 100），易讀易改。

五、 異常與資源管理

12. 構造器異常重拋：構造失敗時重拋異常，防止調用者誤以為對象創建成功。
13. 顯式清理方法：提供 cleanup() + boolean disposed 標記；finalize() 中檢查未清理則拋 RuntimeException 子類（需 System.runFinalizersOnExit(true) 保證執行）。
14. try-finally 確保清理：初始化後立即進入 try { ... } finally { cleanup() }。
15. finalize() 鏈調用順序：覆寫時 super.finalize() 放最後，確保基類組件仍可用。

六、 類型設計原則

16. 固定集合返數組：編譯期類型檢查，調用者無需轉型。
17. 接口優於抽象類：接口定義「做什麼」，類實現「怎麼做」；只有需共享代碼/狀態時才用抽象類。
18. 構造器最小化：僅做狀態初始化，避免調用可覆寫方法（防止構造期多態導致不可預期行為）。
19. 行為豐富的對象：對象不只是數據容器，封裝業務行為。
20. 組合優於繼承：首選「新建/委託」；只有確需「是一種」關係才繼承。
21. 繼承表達行為差異，字段表達狀態差異：如顏色應為字段，不應創建 RedColor/BlueColor 子類。

七、 環境與工程陷阱

22. 類路徑唯一性：確保 classpath 下同名類唯一，避免編譯器誤載入。
23. 事件適配器拼寫陷阱：覆寫適配器方法時拼寫錯誤不會報錯，卻導致方法不生效。
24. 單例模式替代「只創建一個」註釋：將單例約束封裝在類中，而非靠文檔約束。
25. 工廠模式封裝分散創建邏輯：主程序大量創建代碼應提煉為工廠/構建器。

八、 思維與流程原則

26. 拒絕分析癱瘓：先掌握全局再鑽細節，防陷「死邏輯」。
27. 拒絕過早優化：先跑通，有瓶頸再優化（需工具定位），否則犧牲可讀性/可維護性。
28. 代碼讀寫比高：投資清晰設計、註釋、示例，長期收益巨大。
29. 同行評審：邀請外部新視角審查，在低成本階段發現關鍵缺陷。
30. 良好設計回報最高：前期投入尋找正確抽象，後續開發事半功倍。