掌握 C++Builder 除錯藝術：從程式碼品質到進階追蹤技術

前言

Bug 越少，使用者評價越高；開發階段越早發現問題，上線後處理越從容。除錯不僅是用 IDE 單步執行，更是一套涵蓋程式碼撰寫、防禦性設計、記錄追蹤、例外處理的系統工程。本文從基本原則進階到實戰技巧。

一、寫乾淨易讀的程式碼：除錯的基石

• 自文檔化命名：變數、函數名稱表達意圖，減少註解需求
• 函數短小單一：單一職責，易於單元測試與隔離除錯
• 一致風格：縮排、大括號位置、命名慣例統一全專案
• 註解「為什麼」而非「做什麼」：程式碼已說明做什麼，註解解釋決策理由
• 推薦參考：《Clean Code》、《Effective C++》、Scott Meyers 風格指南

二、善用例外處理機制：讓錯誤無法被忽略

傳統錯誤碼的缺失

回傳錯誤碼易被忽略（誰每次都檢查 GetLastError()？），且無法攜帶豐富上下文。

C++ 例外處理優勢

• 強制處理（不捕捉會終止程式）
• 支援型別階層捕捉（基類捕捉衍生類）
• 攜帶任意資料（訊息、錯誤碼、堆疊追蹤）
• 可跨函數邊界傳播

自訂例外類別範例

class MyException : public Exception {
public:
    int ErrorCode;
    AnsiString Context;
    __fastcall MyException(const AnsiString& Msg, int Code, const AnsiString& Ctx)
        : Exception(Msg), ErrorCode(Code), Context(Ctx) {}
};

// 拋出
throw new MyException("Database connection failed", 1001, "ConnectToServer()");

// 捕捉
try {
    ConnectDatabase();
}
catch (MyException& E) {
    LogError(E.Message, E.ErrorCode, E.Context);
    ShowMessage("Error: " + E.Message);
}
catch (Exception& E) {
    // 捕捉所有 VCL 例外（除 ESocketError 外）
    LogError(E.Message);
}
catch (...) {
    // 捕捉所有非 C++ 例外（SEH、外部 DLL 等）
    LogError("Unknown exception");
}

進階技巧

• catch (...) { throw; } 重新拋出，保留原始例外資訊
• __finally { Cleanup(); }（Borland 擴充）確保資源釋放，無論是否拋出例外
• 例外規格（C++11 noexcept）優化效能與表達契約

三、記錄追蹤機制：無 IDE 環境下的救命稻草

服務程式、ISAPI/CGI、即時系統、客戶現場無法連接除錯器時，記錄系統是唯一可見度來源。

方案一：OutputDebugString (Win32 API)

OutputDebugString(L"Entering ProcessOrder()\n");

• 除錯器附著時顯示於輸出視窗
• 無除錯器時自動忽略，零負擔
• 可搭配 DebugView (Sysinternals) 捕捉生產機輸出

方案二：GExperts + dbugintf.pas

• 開源專案，含 SendDebug、SendDebugEx、SendMethodEnter/Exit
• 客戶端 GDebug.exe 獨立運作，未安裝時自動無操作
• 官網：gexperts.org

方案三：自製記錄元件（ListBox OwnerDraw）

• 避免 TRichEdit 記憶體碎片與效能問題
• TListBox 設 Style = lbOwnerDrawFixed 自繪，支援顏色/圖示
• GExperts 主控台即採此架構
• 關鍵：限制最大行數、非同步寫入檔案、關鍵路徑最小化鎖定

記錄內容建議

四、IDE 除錯器進階技巧

• 條件中斷點：i == 999 && user.Id == 123
• 資料中斷點：監視記憶體位址讀寫（追蹤野指標利器）
• 執行緒檢視：切換執行緒、檢視呼叫堆疊、凍結/解凍執行緒
• CPU 視窗：反組譯碼、暫存器、記憶體檢視（解決最佳化導致變數消失）
• 遠端除錯：Remote Debug Server 部署於目標機，IDE 透過 TCP 連接

五、防禦性程式設計清單

1. 所有指標使用前檢查 nullptr
2. 陣列/容器存取檢查邊界（或用 at()）
3. 資源採 RAII（智慧指標、std::lock_guard、自定義包裝器）
4. 輸入驗證：長度、格式、範圍、編碼
5. 斷言 assert() / DebugCheck() 驗證前置/後置條件
6. 最小權限原則：函數參數 const、成員函數 const、變數不可變

結語

除錯藝術的核心是預防大於治療：乾淨程式碼減少 Bug 產生，例外機制讓 Bug 無法隱藏，記錄系統在無 IDE 環境提供可見度，IDE 技巧加速定位。將這些實踐內化為習慣，你將從「滅蟲工」進化為「軟體工程師」。