Java 開發三十條核心規範：從命名到架構的最佳實踐

命名規範

1. 類別名首字母大寫（PascalCase）；變數、方法、物件參考首字母小寫（camelCase）。多單詞駝峰式連接，如 ThisIsAClassName、thisIsMethodOrFieldName。
2. 常數（static final 基本型別）全大寫加底線，如 MAX_CONNECTIONS。
3. 套件名全小寫，即使多單詞也不駝峰，如 com.example.util。

類別設計基礎

4. 經典形式：通用類別應實作 equals()、hashCode()、toString()、clone()（實作 Cloneable）、實作 Serializable。
5. 內建測試：每個類別保留 main() 測試碼，方便回歸驗證與示範用法。

方法設計原則

6. 單一職責：方法簡短、功能單一。過長則拆分，促進重用。
7. 以使用者為中心：API 設計清晰明確；再以維護者角度預判變更點，封裝變化。

類別結構指導

8. 高內聚、低耦合：類別解決單一問題。出現複雜 switch 改用多型；大量型別判斷拆分類別；成員變數差異大拆分類別。
9. 極小化可見性：private 為預設，只暴露必要介面。多執行緒下 private 欄位才能在非同步存取時受保護。
10. 拒絕「上帝物件」：勿將流程式程式碼塞進一兩個巨大物件。物件表達領域概念，而非應用程式本身。
11. 醜陋程式碼內部化：不得已的 hack 封裝在類別內部，不外洩。
12. 善用內部類別：類別間高度耦合時，內部類別可改善封裝與維護。

文件與常數

13. 完整 Javadoc：細緻註解，產出專案文件。
14. 消除魔術數字：以具語意的 static final 常數取代硬編碼數值，提升可讀性與可維護性。

例外與資源管理

15. 建構子失敗快速失敗：捕獲例外後重新拋出，避免呼叫端誤以為物件建立成功。
16. 明確清理介面：提供 cleanup() 等具名方法，配合 boolean disposed 標記；finalize() 中檢查並拋出 RuntimeException 揭露程式錯誤（需確認 JVM 支援 runFinalizersOnExit）。
17. try-finally 確保清理：非 GC 管理資源，初始化成功後立即進入 try { ... } finally { cleanup() } 區塊。

進階建議

18. 慎用繼承，優先組合。
19. 介面隔離：依賴抽象而非具體實作。
20. 不可變物件：預設 final 欄位，無 setter。
21. 防禦性複製：可變參數/回傳值做防禦性拷貝。
22. 集合回傳不可變視圖：Collections.unmodifiableList() 等。
23. 慎用同步：縮小鎖範圍，優先 java.util.concurrent 高階工具。
24. 避免過早優化：先正確、清晰，再依分析器結果優化。
25. 單元測試覆蓋核心邏輯，測試即文件。
26. 程式碼審查文化：同儕審查提早發現設計缺陷。
27. 持續重構：消除重複、改善命名、簡化條件。