Java 開發核心規範：六大關鍵規則提升代碼品質與效能

前言

在 Java 開發過程中，遵循良好的編碼規範不僅能提升程式效能，更能確保代碼的可讀性與可維護性。本文整理出六項國際軟體開發中廣泛認可的核心規則，涵蓋資源管理、執行緒安全、字面常量、文件註解、欄位初始化與國際化支援等關鍵領域，助你寫出更專業、健壯的 Java 代碼。

規則一：JDBC 連接必須在 finally 區塊中關閉

資料庫連接屬於稀缺資源，若因異常導致連接未釋放，將嚴重影響資料庫的並發效能。無論程式正常結束或拋出異常，都必須確保連接被正確關閉。

錯誤示範

try {
    Statement stmt = con.createStatement();
} catch (SQLException e) {
    e.printStackTrace();
}

正確示範

try {
    Statement stmt = con.createStatement();
} finally {
    if (con != null && !con.isClosed()) {
        con.close();
    }
}

使用 finally 區塊可保證在任何情況下（含異常拋出）都能釋放連接。

規則二：避免使用已棄用的 Thread 方法

Thread.resume()、Thread.stop()、Thread.suspend() 及 Runtime.runFinalizersOnExit() 等方法已被標記為棄用，因它們易導致死鎖與資料不一致。請改用 wait()/notify() 或 java.util.concurrent 套件提供的高階同步工具。

參考資源：

• JDK API 文件：java.lang.Thread
• Sun 官方說明：Thread Primitive Deprecation
• Paul Hyde 著《Java Thread Programming》（Sams, ISBN 0-672-31585-8）第 270 頁

規則三：長整數字面常量請使用大寫 L

小寫 l 极易與數字 1 混淆，導致閱讀困難與潛在錯誤。

錯誤示範

long temp = 23434l;

正確示範

long temp = 23434L;

參考：Ken Arnold & James Gosling 著《The Java Programming Language》（第 2 版，Addison-Wesley, 1997）第 108 頁。

規則四：JSP 檔案開頭應加入註解說明

在 JSP 頁面頂端加入註解，說明頁面用途、作者、版本等資訊，有助於團隊協作與後期維護。此規則同樣適用於所有程式碼文件。

範例

<%-- JSP 註解：說明頁面功能 --%>

規則五：明確初始化建構類的所有欄位

未初始化的欄位（特別是靜態欄位）是潛在 Bug 溫床。建議在宣告時或建構子中給予明確初值。

錯誤示範

public class CSI {
    public CSI() { this(12); k = 0; }
    public CSI(int val) { j = val; }
    private int i = 5;
    private int j;
    private int k;
}

正確示範

public class CSIFixed {
    public CSIFixed() { this(12); }
    public CSIFixed(int val) { j = val; k = 0; }
    private int i = 5;
    private int j;
    private int k;
}

參考：AmbySoft Java Coding Standards

規則六：國際化開發中的字元比較與日期格式化

6.1 避免對單一字元使用邏輯運算子

直接比對 'a'..'z' 或 'A'..'Z' 僅適用於英文環境。應使用 Character 類別提供的統一字元判斷方法。

錯誤示範

boolean isLetter = (ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z');

正確示範

boolean isLetter = Character.isLetter(ch);

更多方法請參考 Java 國際化字元處理指南。

6.2 切勿直接使用 Date.toString()

Date.toString() 輸出格式隨地區設定而異，不可用於面向使用者的顯示。應使用 DateFormat 依據 Locale 進行格式化。

錯誤示範

Date today = new Date();
System.out.println(today.toString());

正確示範

Locale locale = Locale.getDefault();
DateFormat df = DateFormat.getDateInstance(DateFormat.DEFAULT, locale);
Date today = new Date();
System.out.println(df.format(today));