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