VC++ 調試利器：TRACE 宏完整使用指南

TRACE 宏簡介

TRACE 是 MFC 提供的除錯巨集，功能類似 printf，但僅存在於 Debug 版本，Release 編譯時自動消失，不增加發布版本體積與效能負擔。

基本語法

TRACE("這是純文字訊息");
TRACE("整數: %d, 字串: %s", 123, "Hello");
TRACE("十六進位: 0x%08X", hr);

支援標準 printf 格式字串。

變體宏：固定參數個數優化

• TRACE0("無參數訊息") — 無額外參數，編譯最精簡
• TRACE1("一個參數: %d", val)
• TRACE2("兩個參數: %d, %s", val, str)
• ... 以此類推至 TRACE3 等

使用對應變體可避免變參處理開銷，Debug 版本效能略優。

輸出位置與檢視

• 輸出至 VC IDE「輸出」視窗（編譯錯誤顯示的那個視窗）
• 限制：僅在 IDE 中以 Debug 模式執行 時顯示；獨立執行 Debug exe 或 Release 版本無輸出

進階技巧

1. 自訂除錯輸出類別

#ifdef _DEBUG
#define MY_TRACE TRACE
#else
#define MY_TRACE __noop
#endif

MY_TRACE("模組初始化完成，句柄=0x%p", hMod);

2. 搭配斷點條件

在中斷點條件欄輸入 TRACE("進入函式, 參數=%d", nParam), 0 可在不修改原始碼情況下輸出除錯資訊。

3. 記憶體洩漏偵測

#ifdef _DEBUG
#define new DEBUG_NEW
#endif
// 配合 TRACE 輸出配置/釋放堆疊資訊

常見誤區

結語

善用 TRACE 系列巨集能大幅提升除錯效率，配合條件中斷點、自訂宏封裝，讓除錯資訊「有求必應、Release 無痕」。