VS2008 MFC 雙對話框項目編譯報錯：頭文件與實現文件不匹配排查

典型錯誤現象

新建兩個對話框類（如 CDlgA、CDlgB），包含頭文件後出現：

• 「未定義的標識符」
• 「語法錯誤：缺少 ';' (在 '}' 前)」
• 「重複定義」

常見原因清單

1. 頭文件互相包含循環：DlgA.h include DlgB.h，反之亦然。解決：前向聲明 class CDlgB;，僅在 .cpp 中包含完整頭文件。
2. 類名與文件名不一致：MFC 向導生成的類名前綴（C）與文件名需對應，手動重命名易導致映射錯誤。
3. 資源 ID 衝突：兩個對話框使用相同的 IDD 資源 ID，導致 resource.h 重複定義。
4. 消息映射宏缺失：BEGIN_MESSAGE_MAP/END_MESSAGE_MAP 拼寫錯誤或遺漏。
5. 預編譯頭設置：stdafx.h 未包含 afxwin.h 或項目屬性中「預編譯頭」選項不一致。

排查步驟

1. 清理解決方案（Build → Clean），刪除 Debug/Release 目錄重新編譯。
2. 檢查輸出窗口第一條錯誤，雙擊定位到具體行。
3. 對比 .h、.cpp、.rc 中的類名、資源 ID 是否一一對應。
4. 使用「類視圖」查看 MFC 是否正確識別兩個對話框類。

最佳實踐

• 新建對話框統一使用 MFC 向導（Add Class → MFC Class → Dialog），避免手動複製代碼。
• 頭文件僅前向聲明依賴類，具體包含移至 .cpp。
• 資源 ID 命名規範：IDD_DLG_A、IDD_DLG_B 區分明確。