C++ Builder CodeGuard 完整指南：記憶體洩漏、資源追蹤與運行期驗證

啟用步驟 (專案層級)

1. 選單 Project → Options → CodeGuard。
2. 勾選 CodeGuard Validation。
3. 建議全開三大檢查項：
   • Invalid pointer / Data overrun：偵測野指標、陣列越界。
   • Method calls on freed objects：偵測 `delete` 後仍呼叫成員函數。
   • Inline pointer validation：驗證內嵌指標 (較慢，大型專案可關閉)。
4. 完全重新建置 (Build All) —— CodeGuard 需插桿代碼至二進位檔，增量編譯無效。

配置工具 (cgconfig.exe)

命令列執行 `cgconfig.exe` 開啟圖形介面，四大分頁：

設定儲存於專案目錄 `cg32.cfg`，隨專案分發。

運行與日誌分析

• IDE 內執行：View → Debug Windows → CodeGuard Log (Ctrl+Alt+O) 即時顯示錯誤樹狀圖。
• 獨立執行：產生同目錄 `.cgl` 文字日誌 (專案名.cgl)，可用記事本開啟。
• 日誌節點雙擊 → 自動跳轉原始碼錯誤行 (需含偵錯資訊)。
• 工具列：Stop (遇錯中斷) / Clear (每次執行清空舊日誌)。

十二大經典錯誤類型與成因

實戰除錯工作流

1. 啟用 CodeGuard + 全項檢查，重新建置。
2. 執行測試案例 (單元測試、手動操作、壓力測試)。
3. 觀察 CodeGuard Log，按錯誤類型分群：優先修復 Access In Freed Memory / Resource Leak / Overrun。
4. 雙擊節點跳轉原始碼，結合 **Watch List / Data Breakpoint** 追蹤變數生命週期。
5. 修復後重新執行驗證，直到 Log 乾淨 (僅剩統計資訊)。
6. 釋出版本前 **關閉 CodeGuard** (專案選項取消勾選) 並重新建置，避免效能負擔 (通常 2-10x 慢)。

效能與限制

• 執行速度下降 **2~10 倍**，記憶體使用量增加 **2~3 倍** (紅區、堆疊填充、追蹤表)。
• 不支援偵測：邏輯錯誤、多執行緒競態、核心模式驅動程式錯誤、最佳化後的內聯函數。
• 大型專案建議：模組化啟用 (僅對懷疑模組開啟)、關閉 Inline Pointer Validation、使用 Ignored Modules 排除穩定第三方 DLL。

現代替代工具

• Visual Studio AddressSanitizer (ASan)：Clang/GCC/MSVC 通用、編譯期插桿、效能損耗 ~2x、支援堆疊/全域/堆積緩衝區溢位、Use-after-free、雙重釋放。
• Valgrind (Memcheck)：Linux 經典、無需重編譯、極詳細記憶體錯誤報告、~20-50x 慢。
• Dr. Memory / Application Verifier：Windows 免費替代方案。

結語

CodeGuard 是 C++ Builder 時代最強大的內建除錯利器，透過「編譯期插桿 + 運行期攔截 + 視覺化日誌」三位一體設計，能快速定位 90% 以上的記憶體與資源管理錯誤。掌握其啟用、配置、日誌分析與十二大錯誤類型，配合現代 Sanitizer 工具鏈，即可建立從開發到上線的完整記憶體安全防線。