Java 開發 30 條核心守則：命名、設計、測試、效能與團隊協作最佳實踐

命名與基本規範

1. 命名慣例：類別首字母大寫（PascalCase），欄位/方法/變數小寫駝峰；常數全大寫底線分隔；套件全小寫。
2. 經典類別範本：通用類別應實作 equals()、hashCode()、toString()、clone()（實作 Cloneable）、Serializable。
3. 內建測試 main()：每個類別保留測試用 main()，方便驗證與示範用法，無需刪除。
4. 方法簡短單一職責：方法應簡潔描述一項功能，過長則拆分，促進復用。
5. 雙重視角設計：先為使用者考慮 API 易用性，再為維護者考慮擴充彈性。

類別設計原則

6. 類別小而專一：解決單一問題。複雜 switch → 多型；操作差異大 → 拆分類別；欄位特徵差異大 → 拆分類別。
7. 極小化公開介面：盡可能 private，只公開必要成員。公開後難以收回，會破壞客戶端代碼。多執行緒下私有欄位才受保護。
8. 避免巨大物件綜合症：勿將流程式程式碼塞入一兩個大物件。物件應表達領域概念，而非應用程式本身。
9. 醜陋代碼封裝：不得已的妥協代碼放入類別內部，勿外洩。
10. 緊耦合改用內部類別：類別間高度耦合時，考慮內部類別改善封裝與維護。

文檔與維護

11. 詳細 Javadoc 註解：產生專業 API 文檔。
12. 消除魔術數字：用具名常數（static final）替代硬編碼數值，提升可讀性與可維護性。
13. 建構子異常處理：建構失敗應重新拋出異常，避免呼叫端誤以為物件建立成功。
14. 明確清理介面：需清理資源的類別提供 cleanup() 方法，配合 boolean disposed 標記與 finalize() 守護（需確認 JVM 支援）。
15. 確定性清理模式：try { init(); } finally { cleanup(); } 確保資源釋放。

繼承與介面

16. finalize() 覆寫順序：最後呼叫 super.finalize()，確保父類別資源仍可用。
17. 固定大小集合回傳陣列：編譯期型別檢查，呼叫端無需轉型。
18. 優先介面、次選抽象類別：介面定義契約，抽象類別提供部分實作。只有需要共享欄位/方法實作才用抽象類別。
19. 建構子最小化邏輯：僅初始化狀態，避免呼叫可被覆寫的方法（可能導致未完全初始化的物件被使用）。
20. 物件應有行為：不只是資料容器，封裝相關行為。

設計決策

21. 組合優於繼承：除非確實是 Is-a 關係，優先用組合/委派。濫用繼承增加不必要複雜度。
22. 用繼承表達行為差異，用欄位表達狀態差異：顏色應為欄位，不應建立 RedColor、BlueColor 子類別。
23. 類別路徑唯一性：確保類別路徑下同名類別僅一個，避免編譯器載入錯誤版本。
24. 事件適配器拼寫陷阱：覆寫適配器方法時拼寫錯誤不會報錯，只會新增方法導致無效果。

架構與心法

25. 消除偽功能：單例需求用 Singleton 模式強制；分散建構邏輯用工廠/建造者封裝。
26. 警惕分析癱瘓：先掌握全局再鑽細節，避免陷入死邏輯。
27. 警惕過早優化：先跑通、再測量、證實瓶頸才優化。優化代價是可讀性與可維護性下降。
28. 代碼讀寫比高：投資清晰設計、註解、範例，未來的你和他人會感謝現在的你。
29. 引入新鮮眼光審查：邀請跨領域同事審查，在低成本階段發現關鍵問題。
30. 良好設計回報最大：找到正確設計雖耗時，後續開發順暢，成功感極高。拒絕草率完工。