掌握 C++Builder 除錯藝術 (一)：寫出乾淨代碼與善用異常處理

前言：除錯不只是按 F9

真正的除錯藝術始於代碼編寫之初。乾淨、可讀、可維護的代碼能從根源上減少 Bug；完善的異常處理與日誌機制能在問題發生時快速定位。本系列將從代碼規範、異常策略、IDE 除錯技巧三大維度，系統提升你的除錯效能。

一、書寫乾淨的代碼

• 命名規範：變數、函式、類別採用一致風味（如 PascalCase / camelCase），見名知意。
• 函式單一職責：每個函式只做一件事，長度控制在一螢幕內。
• 註釋說明「為何」而非「何」：複雜演算法、業務規則、非直觀決定必須留註釋。
• 統一縮排與大括號風格：團隊統一格式化設定，避免無謂衝突。
• 定期重構：消除重複代碼、拆解過大類別、修正命名漂移。

推薦閱讀：《Code Complete》、《Clean Code》、《Effective C++》

二、善用異常與異常處理

為何不用傳統錯誤碼？

• 返回值極易被忽略（如未檢查 CreateFile 返回）。
• 錯誤碼傳遞層層函式，污染業務邏輯。
• 無法攜帶豐富上下文資訊（堆疊、參數、狀態）。

自訂異常類別範例

class AppException {
public:
    AnsiString message;
    int errorCode;
    AppException(const AnsiString& msg, int code = 0) : message(msg), errorCode(code) {}
};

class DBException : public AppException {
public:
    AnsiString sqlState;
    DBException(const AnsiString& msg, const AnsiString& state, int code)
        : AppException(msg, code), sqlState(state) {}
};

拋出與捕獲

void execute_query(const AnsiString& sql) {
    if (!db->Execute(sql)) {
        throw DBException("Query failed", db->GetSQLState(), db->GetErrorCode());
    }
}

try {
    execute_query("SELECT * FROM users");
} catch (DBException& e) {
    LogError(e.message, e.sqlState, e.errorCode);
    ShowMessage("資料庫錯誤：" + e.message);
} catch (AppException& e) {
    LogError(e.message);
    ShowMessage("應用程式錯誤：" + e.message);
} catch (...) {
    LogError("未知嚴重錯誤");
    ShowMessage("系統發生未預期錯誤，請聯繫管理員");
}

異常處理黃金法則

1. 按引用捕獲：catch (Exception& e) 避免切割衍生類資訊。
2. 具體在前，通用在後：先捕獲衍生類，再捕獲基類，最後 catch (...) 兜底。
3. 資源用 RAII 管理：確保異常拋出時鎖、記憶體、檔案自動釋放。
4. 不吞沒異常：除非明確處理完畢，否則重新拋出 throw; 或轉拋更高層異常。

三、建立日誌機制

日誌是事後追蹤的「黑盒子」。關鍵點：

• 分級：Debug / Info / Warning / Error / Fatal。
• 上下文：時間戳、執行緒 ID、函式名、關鍵參數值。
• 非同步寫入：避免 I/O 阻塞主流程，可用專用執行緒或 OutputDebugString。
• 滾動檔案：按大小/日期分割，自動清理舊日誌。

四、結合類別與異常：契約式設計雛形

class Stack {
    std::vector<int> data;
public:
    void push(int v) { data.push_back(v); }
    int pop() {
        if (data.empty()) throw AppException("Stack underflow");
        int v = data.back(); data.pop_back(); return v;
    }
    int top() const {
        if (data.empty()) throw AppException("Stack empty");
        return data.back();
    }
};

前置條件（如非空）失敗即拋出異常，呼叫端無需檢查返回值，代碼更線性清晰。

五、處理外部代碼異常

• 第三方庫 / OS API 可能拋出 SEH 異常或 C++ 異常，邊界處統一捕獲轉換為自訂異常。
• 使用 __try / __except (MSVC) 捕獲結構化異常 (SEH) 並轉為 C++ 異常。

下一步預告

下一篇將深入 C++Builder IDE 除錯器實戰：斷點策略、變數監視、單步執行技巧、Call Stack 分析、CPU 視窗進階用法。