簡介這是一份基于MFC框架開發(fā)的簡易迷宮游戲源碼資源面向正在學(xué)習(xí)C、Windows程序設(shè)計和MFC入門的開發(fā)者。項目通過文檔/視圖架構(gòu)組織代碼利用CWnd進行窗口管理結(jié)合CPen、CBrush等GDI類完成迷宮地圖繪制并借助ON_COMMAND等消息宏實現(xiàn)鍵盤或鼠標(biāo)交互適合作為理解事件驅(qū)動編程與面向?qū)ο笤O(shè)計的練手案例。壓縮包共45個文件約2.13MB包含7個h頭文件、6個cpp源文件、6個obj編譯中間文件以及png、bmp、ico等圖片與圖標(biāo)資源另有rc資源腳本、dsp/dsw工程文件和可執(zhí)行exe覆蓋從源碼到運行結(jié)果的完整工程結(jié)構(gòu)。資源中附有分步驟的png示意圖展示游戲思路與自定義迷宮的創(chuàng)建過程玩家類與迷宮數(shù)據(jù)結(jié)構(gòu)分離清晰便于讀者分析DFS或BFS路徑搜索的實現(xiàn)方式。目前已有378人學(xué)習(xí)下載適合希望從零梳理MFC項目組織、消息映射與圖形繪制流程的初學(xué)者參考。1. 用 MFC 手搓一個迷宮游戲從對話框到鍵盤響應(yīng)的最小閉環(huán)很多人第一次接觸 Windows 桌面開發(fā)都是從 MFC 開始的。但真正讓人卡住的往往不是語法而是“消息循環(huán)到底怎么轉(zhuǎn)”“鍵盤按下去了窗口怎么沒反應(yīng)”。這個用 MFC 做的簡單迷宮游戲恰好是一個能把這些機制串起來的最小可運行項目。它不依賴任何第三方引擎純靠 CDC 繪圖、鍵盤消息和定時器就能跑出一個可玩的小游戲。適合剛學(xué)完 C 語法、想找一個能直接編譯運行的 MFC 練手項目的開發(fā)者也適合想回頭補一補 Windows 消息機制的老手。整個項目結(jié)構(gòu)不復(fù)雜但麻雀雖小消息映射、雙緩沖繪圖、碰撞檢測這些該有的都有。2. 項目結(jié)構(gòu)與技術(shù)選型為什么是 MFC 而不是 Qt2.1 技術(shù)棧拆解這個項目用的是最經(jīng)典的 MFC 對話框程序Dialog-based不是單文檔/多文檔架構(gòu)。選對話框程序的原因很直接迷宮游戲本質(zhì)上就是一個固定大小的窗口不需要菜單欄、工具欄、狀態(tài)欄那一套框架對話框模板反而更輕。核心依賴只有三塊MFC 庫提供 CWnd、CDC、CPaintDC 這些基礎(chǔ)類負(fù)責(zé)窗口創(chuàng)建和繪圖上下文。GDI 繪圖用 CDC 的 Rectangle、Ellipse、TextOut 等接口畫墻、畫玩家、畫終點。Windows 消息機制WM_KEYDOWN 處理方向鍵WM_TIMER 驅(qū)動游戲循環(huán)WM_PAINT 負(fù)責(zé)重繪。常見做法是把游戲邏輯和界面代碼分開但在這個體量的項目里很多人會直接寫在對話框類的成員函數(shù)里。我一般會建議至少把地圖數(shù)據(jù)和渲染拆成兩個函數(shù)不然后面改地圖會很痛苦。2.2 目錄結(jié)構(gòu)說明項目文件不多典型的 MFC 工程結(jié)構(gòu)MazeGame/ ├── MazeGame.sln ├── MazeGame/ │ ├── MazeGame.h // 主對話框類聲明 │ ├── MazeGame.cpp // 主對話框類實現(xiàn)游戲邏輯核心 │ ├── MazeGame.rc // 資源文件對話框模板在這里 │ ├── resource.h // 資源 ID 定義 │ ├── stdafx.h // 預(yù)編譯頭 │ └── res/ │ └── MazeGame.ico真正要看的只有MazeGameDlg.h和MazeGameDlg.cpp兩個文件。地圖數(shù)據(jù)一般用一個二維數(shù)組表示0 代表通路1 代表墻2 代表終點。玩家位置用兩個 int 存行列坐標(biāo)。2.3 對話框初始化與地圖加載在OnInitDialog里做三件事初始化地圖數(shù)組、設(shè)置玩家起點、啟動定時器。BOOL CMazeGameDlg::OnInitDialog() { CDialogEx::OnInitDialog(); // 初始化地圖1 表示墻0 表示通路2 表示終點 int mapData[MAP_ROWS][MAP_COLS] { {1,1,1,1,1,1,1,1,1,1}, {1,0,0,0,1,0,0,0,0,1}, {1,0,1,0,1,0,1,1,0,1}, {1,0,1,0,0,0,1,0,0,1}, {1,0,1,1,1,0,1,0,1,1}, {1,0,0,0,1,0,0,0,0,1}, {1,1,1,0,1,1,1,1,0,1}, {1,0,0,0,0,0,0,0,0,1}, {1,0,1,1,1,1,1,1,2,1}, {1,1,1,1,1,1,1,1,1,1} }; memcpy(m_map, mapData, sizeof(mapData)); m_playerRow 1; // 玩家起始行 m_playerCol 1; // 玩家起始列 m_bGameOver FALSE; SetTimer(TIMER_GAME, 100, NULL); // 100ms 刷新一次 return TRUE; }這里MAP_ROWS和MAP_COLS是宏定義一般設(shè)成 10。定時器 ID 用TIMER_GAME這種有名字的常量別直接寫 1后面加第二個定時器時會后悔。地圖數(shù)組用memcpy拷到成員變量里是因為局部數(shù)組出了函數(shù)就沒了而OnPaint里還要用它來畫墻。注意OnInitDialog返回值必須是 TRUE除非你手動調(diào)用了SetFocus并想返回 FALSE。這個坑我見過不止一個人踩。3. 核心模塊拆解繪圖、鍵盤與碰撞檢測3.1 雙緩沖繪圖避免閃爍直接在每個OnPaint里用CPaintDC畫圖窗口刷新時會閃得厲害。標(biāo)準(zhǔn)做法是雙緩沖先在內(nèi)存 DC 里畫好整張圖再一次性 BitBlt 到屏幕。void CMazeGameDlg::OnPaint() { CPaintDC dc(this); CRect rect; GetClientRect(rect); // 創(chuàng)建內(nèi)存 DC 和兼容位圖 CDC memDC; memDC.CreateCompatibleDC(dc); CBitmap bmp; bmp.CreateCompatibleBitmap(dc, rect.Width(), rect.Height()); memDC.SelectObject(bmp); // 先填充背景 memDC.FillSolidRect(rect, RGB(240, 240, 240)); // 畫迷宮 for (int i 0; i MAP_ROWS; i) { for (int j 0; j MAP_COLS; j) { int x j * CELL_SIZE; int y i * CELL_SIZE; if (m_map[i][j] 1) { memDC.FillSolidRect(x, y, CELL_SIZE, CELL_SIZE, RGB(60, 60, 60)); } else if (m_map[i][j] 2) { memDC.FillSolidRect(x, y, CELL_SIZE, CELL_SIZE, RGB(0, 180, 0)); } } } // 畫玩家 int px m_playerCol * CELL_SIZE; int py m_playerRow * CELL_SIZE; memDC.FillSolidRect(px 4, py 4, CELL_SIZE - 8, CELL_SIZE - 8, RGB(220, 60, 60)); // 一次性貼到屏幕 dc.BitBlt(0, 0, rect.Width(), rect.Height(), memDC, 0, 0, SRCCOPY); }CELL_SIZE是每個格子的像素大小一般設(shè) 40 或 50。FillSolidRect比Rectangle少畫邊框性能更好。玩家方塊留了 4 像素邊距視覺上不會和墻貼死。內(nèi)存 DC 用完不需要手動 DeleteCDC 和 CBitmap 的析構(gòu)函數(shù)會處理但如果你在循環(huán)里反復(fù)創(chuàng)建那就要注意了。3.2 鍵盤消息處理MFC 對話框默認(rèn)不接收方向鍵的WM_KEYDOWN因為方向鍵會被用來在控件之間切換焦點。解決辦法是重寫PreTranslateMessage。BOOL CMazeGameDlg::PreTranslateMessage(MSG* pMsg) { if (pMsg-message WM_KEYDOWN !m_bGameOver) { int newRow m_playerRow; int newCol m_playerCol; switch (pMsg-wParam) { case VK_UP: newRow--; break; case VK_DOWN: newRow; break; case VK_LEFT: newCol--; break; case VK_RIGHT: newCol; break; default: return CDialogEx::PreTranslateMessage(pMsg); } // 碰撞檢測撞墻就不動 if (m_map[newRow][newCol] ! 1) { m_playerRow newRow; m_playerCol newCol; // 到達(dá)終點 if (m_map[newRow][newCol] 2) { m_bGameOver TRUE; KillTimer(TIMER_GAME); MessageBox(_T(恭喜通關(guān)), _T(提示), MB_OK); } Invalidate(); // 觸發(fā)重繪 } return TRUE; // 消息已處理不再傳遞 } return CDialogEx::PreTranslateMessage(pMsg); }PreTranslateMessage是在消息進入窗口過程之前攔截的所以能拿到方向鍵。Invalidate()會觸發(fā)OnPaint但不會立即執(zhí)行Windows 會合并多次無效區(qū)域。碰撞檢測只判斷了目標(biāo)格子是不是墻沒有做邊界檢查——因為地圖最外圈全是墻玩家走不出去。如果你改地圖時把外圈拆了記得補上邊界判斷不然數(shù)組越界就是另一個故事了。3.3 定時器與游戲循環(huán)這個項目用SetTimer驅(qū)動一個簡單的游戲循環(huán)主要用來做兩件事刷新畫面和處理計時邏輯。void CMazeGameDlg::OnTimer(UINT_PTR nIDEvent) { if (nIDEvent TIMER_GAME) { // 這里可以加計時、動畫等邏輯 // 當(dāng)前版本只做重繪 Invalidate(); } CDialogEx::OnTimer(nIDEvent); }100ms 的間隔對于迷宮游戲來說足夠了人眼看起來是連續(xù)的。如果你要做移動動畫可以把間隔調(diào)到 30ms 左右然后在OnTimer里更新玩家像素偏移量。但那樣就得把玩家坐標(biāo)從格子坐標(biāo)改成像素坐標(biāo)復(fù)雜度會上一個臺階。這個版本保持格子對齊邏輯最簡單。提示KillTimer一定要在OnDestroy或OnCancel里再調(diào)一次防止窗口關(guān)閉后定時器還在跑。4. 編譯運行與常見問題排查4.1 環(huán)境配置與編譯步驟這個項目需要 Visual Studio推薦 2017 及以上版本社區(qū)版就夠。安裝時記得勾選“使用 C 的桌面開發(fā)”工作負(fù)載MFC 組件在單個組件里手動勾上。編譯步驟用 VS 打開MazeGame.sln。確認(rèn)解決方案平臺是 x86 或 x64Debug 或 Release 都行。如果提示找不到 MFC 頭文件右鍵項目 → 屬性 → 配置屬性 → 常規(guī) → “使用 MFC”改成“在共享 DLL 中使用 MFC”。F5 運行。如果編譯報錯fatal error C1083: 無法打開包括文件: afxwin.h就是 MFC 組件沒裝。打開 VS Installer修改 → 單個組件 → 搜索 MFC → 勾選對應(yīng)版本。4.2 常見問題排查現(xiàn)象一方向鍵按了沒反應(yīng)。原因?qū)υ捒蚰J(rèn)把方向鍵當(dāng)焦點切換處理了。 解決確認(rèn)PreTranslateMessage已經(jīng)重寫并且返回了 TRUE。如果還是不行檢查對話框上是不是有按鈕控件搶了焦點可以在OnInitDialog里把焦點設(shè)到對話框本身?，F(xiàn)象二窗口閃爍嚴(yán)重。原因OnPaint里直接往CPaintDC上畫沒有用雙緩沖。 解決按 3.1 的寫法加內(nèi)存 DC。另外在OnEraseBkgnd里直接返回 TRUE阻止系統(tǒng)擦背景?，F(xiàn)象三玩家能穿墻。原因碰撞檢測寫成了if (m_map[newRow][newCol] 0)才移動但終點格是 2也會被擋住。 解決判斷條件改成! 1這樣通路和終點都能走?，F(xiàn)象四通關(guān)后還能繼續(xù)走。原因m_bGameOver標(biāo)志沒在鍵盤處理里判斷。 解決在PreTranslateMessage開頭加!m_bGameOver條件通關(guān)后直接忽略按鍵?，F(xiàn)象五Release 模式下地圖顯示錯亂。原因局部數(shù)組mapData在 Debug 下可能被零初始化Release 下不會。 解決確保memcpy的長度用sizeof(mapData)并且成員數(shù)組大小和局部數(shù)組完全一致。5. 二次開發(fā)改造從固定地圖到可編輯關(guān)卡這個項目最值得改的地方就是地圖?，F(xiàn)在地圖是硬編碼在OnInitDialog里的想換個迷宮就得重新編譯。我一般會把它改成從文本文件讀取這樣關(guān)卡設(shè)計就獨立出來了。void CMazeGameDlg::LoadMapFromFile(LPCTSTR filePath) { CStdioFile file; if (!file.Open(filePath, CFile::modeRead | CFile::typeText)) { AfxMessageBox(_T(地圖文件打開失敗)); return; } CString line; int row 0; while (file.ReadString(line) row MAP_ROWS) { for (int col 0; col MAP_COLS col line.GetLength(); col) { m_map[row][col] line[col] - _T(0); // 字符轉(zhuǎn)數(shù)字 } row; } file.Close(); }地圖文件格式就是每行一串?dāng)?shù)字比如1111111111表示一行墻。這樣改關(guān)卡不用動代碼用記事本就能編。CStdioFile是 MFC 自帶的文件類處理文本比ifstream在 Unicode 環(huán)境下更省心。另一個改造方向是加計時和步數(shù)統(tǒng)計。在OnTimer里累加時間在鍵盤處理里累加步數(shù)然后在OnPaint里用TextOut畫到窗口頂部。注意TextOut要放在雙緩沖的memDC上不然文字會閃。// 在 OnPaint 的雙緩沖繪制部分加入 CString info; info.Format(_T(步數(shù): %d 時間: %d 秒), m_stepCount, m_elapsedSeconds); memDC.SetBkMode(TRANSPARENT); memDC.TextOut(10, 10, info);SetBkMode(TRANSPARENT)讓文字背景透明不然會有一個白底方塊蓋住迷宮。m_elapsedSeconds在OnTimer里每 10 次 tick 加 1因為定時器是 100ms。還有一個容易忽略的點窗口大小。對話框模板默認(rèn)大小可能和地圖尺寸對不上導(dǎo)致迷宮畫不全。我一般會在OnInitDialog里根據(jù)MAP_ROWS * CELL_SIZE和MAP_COLS * CELL_SIZE動態(tài)調(diào)整窗口客戶區(qū)大小。// 在 OnInitDialog 末尾調(diào)整窗口大小 CRect rect(0, 0, MAP_COLS * CELL_SIZE, MAP_ROWS * CELL_SIZE 40); AdjustWindowRect(rect, GetStyle(), FALSE); SetWindowPos(NULL, 0, 0, rect.Width(), rect.Height(), SWP_NOMOVE | SWP_NOZORDER);40是給頂部信息欄留的空間。AdjustWindowRect會把客戶區(qū)尺寸換算成包含邊框和標(biāo)題欄的窗口尺寸。這一步不做的話地圖右下角會被截掉而且不同 DPI 下表現(xiàn)還不一樣。從那以后我每次寫 MFC 繪圖程序都會先把雙緩沖和窗口尺寸自適應(yīng)這兩步做掉再寫業(yè)務(wù)邏輯。不然等地圖畫出來再回頭改OnPaint里已經(jīng)堆了一堆代碼動起來很容易翻車。希望這個迷宮項目能幫你把 MFC 的消息機制和 GDI 繪圖跑通后面再改什么功能心里都有底。本文還有配套的精品資源點擊獲取