VC++ 啟用 CRT 偵錯堆檢測記憶體洩漏完整指南

啟用步驟 (標頭檔順序嚴格)

#define _CRTDBG_MAP_ALLOC     // 必須最前，映射 malloc/free 至 _malloc_dbg/_free_dbg
#include 
#include            // 定義 _CrtDumpMemoryLeaks 等

僅在 _DEBUG 定義時生效 (Debug 版)。Release 版不受影響。

基本用法

// 程式結束前手動呼叫
_CrtDumpMemoryLeaks();

輸出範例：

Detected memory leaks!
Dumping objects ->
{145} normal block at 0x00A4B8C0, 64 bytes long.
Data: < CD CD CD CD CD CD CD CD CD CD CD CD CD CD CD CD >
Object dump complete.

若定義 _CRTDBG_MAP_ALLOC，輸出額外包含 **檔案名與行號**：leaktest.cpp(20)。

自動檢測 (無需手動呼叫)

// 程式進入點 (如 CWinApp::InitInstance) 最早處
_CrtSetDbgFlag(_CRTDBG_ALLOC_MEM_DF | _CRTDBG_LEAK_CHECK_DF);

程式正常退出時自動呼叫 _CrtDumpMemoryLeaks。適用多出口程式。

進階控制

常見誤區

• 放在 stdafx.h 但順序錯誤：_CRTDBG_MAP_ALLOC 必須在 stdlib.h **之前**，crtdbg.h **之後**。
• 以為能檢測 new/delete：crtdbg.h 已將 new/delete 映射至 _malloc_dbg/_free_dbg，**可檢測**。
• 第三方庫洩漏誤報：若第三方靜態庫未啟用 Debug CRT，其洩漏不會被追蹤；動態庫各自有獨立堆。

最佳實踐流程

1. 專案 stdafx.h 頂端加入三行啟用代碼。
2. CWinApp::InitInstance 首行加 _CrtSetDbgFlag(...) 自動檢測。
3. 洩漏報告出現 {配置序號} → 專案設定 → Debug → Program arguments 加 /heapcheck:145 (或代碼 _CrtSetBreakAlloc(145)) 重跑偵錯。
4. 斷點命中處即為洩漏配置點，檢查對應 new 是否有配對 delete。