Java 程式設計 30 條核心建議：從命名規範到架構思維

前言

優秀的 Java 代碼不僅能運行，更要易讀、易維護、易擴展。本文整理 30 條核心建議，涵蓋命名規範、類設計、方法設計、異常處理、效能優化、團隊協作等維度，助你寫出專業級代碼。

命名與格式規範 (1-2)

1. 類名 PascalCase：UserService；方法/變數/物件 camelCase：getUserById；常數全大寫底線分隔：MAX_RETRY_COUNT
2. 套件名全小寫：com.company.project.module，網域擴展名亦小寫

類設計原則 (3-10)

3. 經典類範本：自訂類建議實作 equals()、hashCode()、toString()、clone() (implements Cloneable)、Serializable
4. 內建測試 main()：每個類保留 main() 單元測試代碼，便於驗證與示例
5. 方法單一職責：方法短小精悍，只做一件事；過長則拆分
6. 以客戶視角設計 API：使用者視角直觀易用；以維護者視角預留擴展點
7. 類專注單一問題：複雜 switch → 多型；巨大方法操作差異大 → 拆分類；成員變數差異大 → 拆分類
8. 最小公開原則：能 private 就 private；能 package-private 就不 public；多執行緒下 private 保護共享狀態
9. 避免「上帝物件」：不要將流程式代碼塞進大類；物件表達領域概念而非流程
10. 醜陋代碼隔離：不得已的 hack 放入獨立類，勿污染核心邏輯
11. 緊密耦合改內部類：類間高度依賴時考慮內部類改善封裝
12. 完善文檔註釋：javadoc 生成專案文檔，投資未來可讀性

代碼品質提升 (11-18)

11. 消除魔術數字：if (status == 100) → if (status == Status.SUCCESS.code)
12. 建構子異常處理：建構失敗必須拋出異常，避免呼叫端誤以為物件建立成功
13. 明確清理契約：需清理資源的類提供 cleanup()，內部 boolean disposed 標記，finalize() 兜底檢查並拋出 RuntimeException
14. try-finally 確保清理：初始化成功後立即進入 try { ... } finally { cleanup() }
15. finalize() 正確鏈：覆寫時最後呼叫 super.finalize()，確保父類資源仍可用
16. 固定集合用陣列：大小固定的物件集合用陣列，編譯期類型檢查、免轉型
17. 優先介面而非抽象類：介面定義契約，抽象類僅在需共享實作/狀態時使用
18. 建構子最小化：僅做狀態初始化，避免呼叫可被覆寫的方法（防止構造期洩漏 this）

物件導向思維 (19-24)

19. 物件擁有行為：不只是資料容器，行為同樣重要
20. 組合優於繼承：預設用組合/委派；只有滿足 is-a 且需多態時才繼承
21. 繼承表達行為差異，欄位表達狀態差異：顏色用 Color 欄位，勿用繼承表達顏色
22. 類路徑唯一性：同名類只能出現一次，否則編譯器可能載入錯誤版本
23. AWT 事件適配器陷阱：覆寫適配器方法時拼寫錯誤不會報錯，只會新增方法
24. 消除偽單例：不要用註釋限制「只建一個」，用單例模式或工廠封裝

工程效能與心法 (25-30)

25. 防止分析癱瘓：先掌握全局再鑽細節，避免陷入死邏輯
26. 拒絕過早優化：先跑通、再測量、有瓶頸才優化；優化代價是可讀性
27. 代碼讀多寫少：投資註釋、說明、範例，回報率最高
28. 尋求外部審視：邀請不同視角的人審查，早期發現盲點
29. 良好設計回報最大：前期投入設計時間，後期節省數倍掙扎成本
30. 堅持完成度：抵制草率交付誘惑，技術債最終會加倍償還

精選代碼示範

魔術數字消除

// 差
if (user.getType() == 3) { ... }

// 好
public enum UserType { ADMIN(1), VIP(2), NORMAL(3); }
if (user.getType() == UserType.NORMAL.code) { ... }

建構子最小化

// 風險：呼叫可覆寫方法
public class Base {
    public Base() { init(); } // 危險！
    protected void init() { ... }
}

// 安全：建構子僅初始化欄位
public class Safe {
    private final String config;
    public Safe(String config) { this.config = config; }
    public void initialize() { ... } // 由呼叫端顯式調用
}

組合優於繼承

// 繼承：僵硬、破壞封裝
class Bird extends Animal { ... }

// 組合：靈活、可運行期替換
interface FlyBehavior { void fly(); }
class Bird { 
    private FlyBehavior flyBehavior;
    public void setFlyBehavior(FlyBehavior fb) { this.flyBehavior = fb; }
    public void fly() { flyBehavior.fly(); }
}

總結

這 30 條建議蒐羅自實戰經驗與經典著作（如 Effective Java、Thinking in Java）。它們不是僵化規則，而是指引決策的羅盤。內化這些原則，你的代碼將更健壯、團隊協作更順暢、系統演進更從容。建議列印張貼工位，每日審視一條，久久為功。