Visual C++ 記憶體洩漏偵測與定位完整指南：CRT Debug Heap、_CrtDumpMemoryLeaks、斷點追蹤

C/C++ 手動記憶體管理雖靈活但極易洩漏。Visual C++ CRT Debug Heap 提供強大的內建洩漏偵測工具，零第三方依賴，本文系統介紹啟用方法、報告解讀、自動檢測、分配編號斷點定位、記憶體區塊類型區分、報告輸出重導向等完整技能。

一、 啟用偵測：必要的標頭與順序

// 必須在所有標頭之前，且順序固定
#define _CRTDBG_MAP_ALLOC       // 映射 malloc/free 到 _malloc_dbg/_free_dbg
#include 
#include              // 提供 _CrtDumpMemoryLeaks 等

• 僅在 Debug 版本 生效 (定義 _DEBUG)，Release 版仍用標準 malloc/free。
• _CRTDBG_MAP_ALLOC 讓洩漏報告包含 檔案名與行號，極其關鍵。

二、 手動觸發洩漏報告

int main() {
    // ... 程式邏輯 ...
    _CrtDumpMemoryLeaks(); // 程式結束前呼叫
    return 0;
}

輸出至 Output 視窗 -> Debug 標籤。

三、 自動檢測：_CrtSetDbgFlag (推薦)

int main() {
    // 程式一開始設定：退出時自動呼叫 _CrtDumpMemoryLeaks
    _CrtSetDbgFlag(_CRTDBG_ALLOC_MEM_DF | _CRTDBG_LEAK_CHECK_DF);
    // ...
}

適用於多出口函數、異常退出等場景，無需在每個 return 處理。

四、 讀懂洩漏報告

Detected memory leaks!
Dumping objects ->
c:\projects\leaktest.cpp(20) : {18} normal block at 0x00780E80, 64 bytes long.
Data: < > CD CD CD CD CD CD CD CD CD CD CD CD CD CD CD CD
Object dump complete.

• {18}：分配編號 (第 18 次分配)。
• normal block：區塊類型 (見下表)。
• 0x00780E80：位址。
• 64 bytes：大小。
• c:\projects\leaktest.cpp(20)：分配源碼位置 (需 _CRTDBG_MAP_ALLOC)。
• Data：前 16 字節內容 (十六進位)，CD = 未初始化填充模式。

五、 記憶體區塊類型對照

六、 分配編號斷點精準定位

洩漏報告顯示 {18}，表示第 18 次分配洩漏。但該行代碼可能被呼叫多次，只有第 18 次洩漏。利用 分配編號斷點 精準捕捉該次分配。

操作步驟

1. 專案設定中斷點 (F9) 在程式進入點 (如 main 首行)。
2. 開始偵錯 (F5)，中斷於入口。
3. 開啟 Watch 視窗，輸入：
   • 靜態連結 CRT：_crtBreakAlloc
   • 動態連結 CRT (預設 MDd)：**{,,ucrtbased.dll}_crtBreakAlloc** (VS2015+) 或 {,,msvcrtd.dll}_crtBreakAlloc (舊版)
4. 將值改為洩漏編號 (如 18)。
5. 繼續執行 (F5)，程式將在第 18 次 malloc/new 處中斷，呼叫堆疊直接顯示完整調用鏈。

七、 重導向報告輸出

// 輸出到檔案而非 Output 視窗
_CrtSetReportMode(_CRT_WARN, _CRTDBG_MODE_FILE);
_CrtSetReportFile(_CRT_WARN, _CRTDBG_FILE_STDOUT); // 或 _CRTDBG_FILE_STDERR / 檔案控制代碼
// 也可用 _CRTDBG_MODE_DEBUG 輸出到偵錯器 (預設)

八、 進階：記憶體狀態檢查點

_CRT_MEM_STATE s1, s2, s3;
_CrtMemCheckpoint(&s1); // 快照 1
// ... 執行可疑代碼 ...
_CrtMemCheckpoint(&s2); // 快照 2
if (_CrtMemDifference(&s3, &s1, &s2)) {
    _CrtMemDumpStatistics(&s3); // 輸出差異統計
    _CrtMemDumpAllObjectsSince(&s1); // 傾印 s1 後所有分配物件
}

總結最佳實踐

1. 專案 stdafx.h 頂部加入 _CRTDBG_MAP_ALLOC + crtdbg.h。
2. CWinApp::InitInstance 首行 _CrtSetDbgFlag(_CRTDBG_ALLOC_MEM_DF | _CRTDBG_LEAK_CHECK_DF);。
3. Debug 版本每次運行自動報告洩漏。
4. 有洩漏時，用分配編號斷點精準定位源碼行與調用堆疊。 5. 修復後重測至 Object dump complete 無 Detected memory leaks。

掌握 CRT Debug Heap，記憶體洩漏不再是噩夢。

1. 上一篇文章： Vista/Win7/Win10+ 透過 Manifest 讓 VC++ 應用程式自動提權 (UAC 管理員權限)
2. 下一篇文章： VC++ 程式碼動態建立/修改/刪除 ODBC 資料源 (DSN)：SQLConfigDataSource 完整實現

VC 教學

自製調試診斷工具系列（一）：DLL 依賴衝突排查三大利器

背景：DLL Hell 依舊存在 雖然 .NET 組件並行運

VC++ 自繪顏色下拉方塊：ComboBox 實作色盤選擇器

前言 Word 的字型顏色下拉選單以色塊+文字呈現，極具直觀

VC++ 擴充 CRichEditCtrl 實作右鍵選單與字體設定：撤銷/剪貼/複製/貼上/全選/字型

前言 MFC `CRichEditCtrl` 功能強大支援富

Win32 多線程串口通訊實戰：從基礎 API 到完整工程範例

前言 在工業控制與嵌入式系統開發中，串口通訊是最基礎也最關鍵