程式設計風格規範系列（五）：錯誤處理策略與斷言最佳實踐

前言

本系列第五部分聚焦 **錯誤處理**：如何分類上報、盡早發現、嚴格測試，構建健壯軟體的防線。

一、錯誤上報分類：依 UI 相關性決定機制

通用錯誤處理函數：集中 `switch(errCode)` 處理，避免分散式 `if-else` 污染業務邏輯。

二、盡早發現錯誤：三大手段

1. 重視編譯器警告

• 警告往往揭示潛在缺陷 (型別轉換遺失精度、未初始化變數、有號/無號比較)。
• **策略**：`/W4` (MSVC) 或 `-Wall -Wextra` (GCC/Clang) + **視警告為錯誤** (`/WX` / `-Werror`)，強迫修正才能編譯通過。

2. 善用斷言 —— 開發期守門員

適用場景 (必加斷言)

• 函數入口參數驗證，特別是指標非空、索引邊界、狀態前置條件。
• 程式設計假設 (如「此處鎖定已被持有」、「該物件必須已初始化」)。
• 自以為「不可能發生」的分支 (防禦性程式設計核心)。

斷言 vs 運行期檢查

混合策略 (高頻/效能敏感函數)

// 開發期斷言攔截程式錯誤，釋出版仍保留基本防護
ASSERT(pvToMem && pvFromMem);           // Debug 攔截空指標
if (!pvToMem || !pvFromMem) {           // Release 基本防護
    return CM_POINT_IS_NULL;
}

原則：高頻/效能敏感 → 斷言 + 最小運行期檢查；一般函數 → 完整運行期檢查；Debug 版所有內部 DLL/EXE 必須帶斷言符號。

3. 嚴格測試：覆蓋邊界與臨界點

• 每段代碼入庫前必須通過單元測試。
• 重點測試：零值、最大/最小值、空指標、空容器、逾時、權限拒絕、網路中斷、磁碟滿。
• 目標：**零已知缺陷交付** (Zero Known Defects)。

三、錯誤處理代碼範本

long cmMemCpy(void* pvTo, const void* pvFrom, size_t sz)
{
    long lResult = CM_OK;
    ASSERT(pvTo && pvFrom);                 // 開發期契約檢查
    if (!pvTo || !pvFrom) {                 // 運行期基本防護
        lResult = CM_POINT_IS_NULL;
        goto END;
    }
    // ... 核心邏輯 ...
END:
    return lResult;
}

總結

錯誤處理的核心哲學是 **「分層防禦」**：

1. **編譯期**：最高警告等級 + 視警告為錯誤，攔截語法/型別層面隱患。
2. **開發期**：斷言驗證契約與假設，零成本捕捉程式設計錯誤。
3. **測試期**：系統化邊界測試，暴露邏輯與環境互動缺陷。
4. **運行期**：非 UI 函數回傳錯誤碼，UI 函數就地處理，統一錯誤碼體系貫穿始終。

斷言不是「偷懶不寫檢查」，而是 **「精準區分程式錯誤與運行錯誤」** 的專業工具。正確使用斷言，能同時獲得開發期高敏感度與釋放版高效能，是成熟 C/C++ 工程師的標誌技能之一。