您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

Java 代碼規範指北：8 類常見不規範代碼與 IDE 自動修復實戰

編輯：Java 相關知識

工具鏈先行：Eclipse 格式化與 Import 管理

良好的代碼風格始於工具自動化，而非人工對齊。

核心快捷鍵

Ctrl + Shift + F：格式化源代碼（縮進、大括號、空格統一）
Ctrl + Shift + O：整理 Import（移除未用、排序、添加缺失）

保存時自動執行（強烈推薦）

Window → Preferences → Java → Editor → Save Actions → 勾選 Perform the selected actions on save → 選中 Format source code + Organize imports

效果：每次 Ctrl+S 自動修復風格問題，團隊零爭議。

八大不規範模式與重構方案

1. 方法多出口（多 return 語句）

// ❌ 不推薦：多個返回點，難以調試與維護
public boolean isEligible(User user) {
    if (user == null) return false;
    if (user.getAge() < 18) return false;
    if (!user.isActive()) return false;
    return true;
}

// ✅ 推薦：單一出口，邏輯清晰
public boolean isEligible(User user) {
    boolean eligible = false;
    if (user != null && user.getAge() >= 18 && user.isActive()) {
        eligible = true;
    }
    return eligible;
}

2. If-Else 可簡化為表達式

// ❌ 冗長
public String getStatus(boolean active) {
    if (active) return "啟用";
    else return "禁用";
}

// ✅ 三元運算符 / 表達式
public String getStatus(boolean active) {
    return active ? "啟用" : "禁用";
}

3. 基本類型包裝類無謂 new

// ❌ 創建新對象，性能差、內存壓力
Boolean b = new Boolean(true);
Integer i = new Integer(100);
String s = new String("hello");

// ✅ 靜態工廠方法，享受緩存與複用
Boolean b = Boolean.valueOf(true);  // 返回 Boolean.TRUE/FALSE 單例
Integer i = Integer.valueOf(100);   // -128~127 緩存
String s = "hello";                 // 字面量直接引用常量池

4. 缺失大括號的流程控制

// ❌ 極易導致維護時邏輯錯誤
if (condition)
    doSomething();
    doAnother(); // 視覺上屬於 if，實際無條件執行！

// ✅ 永遠加大括號，即使單行
if (condition) {
    doSomething();
}
doAnother(); // 明確不屬於 if

5. 方法參數未聲明 final

// ✅ 推薦：參數聲明 final
public void process(final String input, final int maxRetry) {
    // 編譯器保證不會意外修改參數引用
    // 字節碼優化：final 參數可內聯常量傳遞
}

6. 常量命名不規範

// ❌ 混淆視聽
public static final String apiUrl = "https://api.example.com";
private static final int maxCount = 100;

// ✅ 全大寫 + 下劃線，一眼識別常量
public static final String API_URL = "https://api.example.com";
private static final int MAX_COUNT = 100;

7. 分散的條件判斷可合併

// ❌ 重複判斷
if (user != null) {
    if (user.isActive()) {
        if (user.getAge() >= 18) { ... }
    }
}

// ✅ 合併邏輯
if (user != null && user.isActive() && user.getAge() >= 18) { ... }

8. Switch 缺失 default 分支

// ❌ 新增枚舉值時靜默失效
switch (status) {
    case 1: return "啟用";
    case 2: return "禁用";
}

// ✅ 防禦性編程
switch (status) {
    case 1: return "啟用";
    case 2: return "禁用";
    default: throw new IllegalArgumentException("未知狀態：" + status);
}

9. 重複字符串字面量未提取常量

// ❌ 分散維護風險
log.info("用戶登錄成功：{}", username);
audit.record("用戶登錄成功：{}", username);
notify.send("用戶登錄成功：{}", username);

// ✅ 提取常量
private static final String LOGIN_SUCCESS_MSG = "用戶登錄成功：{}";
log.info(LOGIN_SUCCESS_MSG, username);
audit.record(LOGIN_SUCCESS_MSG, username);
notify.send(LOGIN_SUCCESS_MSG, username);