MFC单机记忆翻牌游戏：消息映射、状态机与GDI双缓冲实战

简介这是一份面向C与Windows编程初学者的单机记忆翻牌游戏完整源码工程基于MFC对话框框架实现适合用来练习界面布局、消息映射、计时器、位图加载与资源管理等知识点。压缩包共419个文件以384个bmp图像资源为主配套9个cpp与11个h源码文件、5个mp3音效以及sln、vcxproj、rc等工程与资源文件整体约6.63MB可直接用于编译学习和二次修改。已有507人学习下载。读者可从中了解卡片动态创建、翻牌点击响应、配对判定、错配自动翻回、计分与音效播放等模块的实现方式也能对照完整目录和工程配置梳理MFC小游戏从界面搭建到事件处理的开发流程。包内图片与音效素材较为完整便于替换主题后用于课程设计参考、期末项目借鉴与Windows桌面应用开发入门实践。1. 单机记忆翻牌游戏翻两张牌容易状态收得住才算入门单机记忆翻牌游戏这个题目在 VC/MFC 课程设计里出现频率很高但很多人把源码拖进 VS 后第一件事是找“开始游戏”按钮结果翻遍对话框也找不到——游戏入口其实藏在OnLButtonDown里牌面在OnPaint里画回翻靠SetTimer。它适合想练手 MFC 消息映射、GDI 绘图和状态机的开发者也适合需要一个能跑通的桌面小项目做二次开发的人。别被“小游戏”三个字骗了牌堆、翻牌锁、匹配延时、重绘刷新这些点串起来正好是一条完整的桌面交互链路哪一环没收紧表现就是“点不动”“乱翻牌”“最小化回来白屏”。2. 工程结构与技术选型MFC 对话框程序怎么拆出游戏循环2.1 从 .sln 到资源脚本一个 VC/MFC 工程的最小骨架拿到这份单机记忆翻牌游戏源码先别急着按 F5。把目录展开典型结构一般长这样解决方案文件、项目文件、资源脚本、预编译头、对话框类、卡牌数据类以及res下的位图资源。MFC 工程不像纯控制台程序只有一个main它的入口在CWinApp派生类的InitInstance里主界面通常是一个CDialogEx派生对话框DoModal一调消息循环就交给框架了。文件/目录作用先看什么*.sln解决方案入口用 VS 打开后先重定目标*.vcxproj编译配置字符集、MFC 链接方式、平台工具集*.rc/resource.h对话框、位图、控件 ID资源 ID 是否和代码里一致GameDlg.h/.cpp主对话框消息处理鼠标、定时器、绘制入口Card.h/.cpp卡牌数据与牌堆状态字段、匹配字段res/牌面、牌背、图标位图是否导入、ID 是否重名真正需要先建立认知的是消息映射。MFC 不靠重写虚函数处理所有交互而是在对话框类里用BEGIN_MESSAGE_MAP把 Windows 消息和成员函数绑起来。下面这段是翻牌游戏里最常见的骨架// GameDlg.h class CGameDlg : public CDialogEx { DECLARE_MESSAGE_MAP() public: afx_msg void OnLButtonDown(UINT nFlags, CPoint point); afx_msg void OnTimer(UINT_PTR nIDEvent); afx_msg void OnPaint(); afx_msg BOOL OnEraseBkgnd(CDC* pDC); }; // GameDlg.cpp BEGIN_MESSAGE_MAP(CGameDlg, CDialogEx) ON_WM_LBUTTONDOWN() ON_WM_TIMER() ON_WM_PAINT() ON_WM_ERASEBKGND() END_MESSAGE_MAP()这段映射的作用是把鼠标左键、定时器、重绘和背景擦除四条消息接到对话框成员函数上。ON_WM_LBUTTONDOWN()不需要写函数名MFC 会按约定找OnLButtonDownON_WM_TIMER()对应OnTimer参数nIDEvent用来区分是回翻计时器还是游戏总计时器。参数point是客户区坐标不是屏幕坐标这一点在后面命中检测里会反复用到。OnEraseBkgnd返回TRUE表示背景由我们自己画常用于双缓冲避免闪烁。工程骨架看清后编译配置里还有三个开关会直接影响能不能跑平台工具集决定用哪套编译器和 SDKMFC 使用方式决定是静态链接还是共享 DLL字符集决定CString和资源字符串按 Unicode 还是多字节处理。老工程经常在这三处翻车第 4 章会单独拆。2.2 视图、对话框与游戏对象谁负责画牌谁负责判胜负翻牌游戏最容易写成“一个对话框类包打天下”牌堆数组、鼠标命中、匹配判断、计时计分、绘图全塞进GameDlg.cpp。能跑但改起来很痛苦。合格一点的拆法是三层对话框负责窗口和消息游戏板对象负责牌堆和规则卡牌对象只存自己的数据。常见做法是CGameDlg持有CGameBoard m_boardCGameBoard里放std::vectorCCard所有“能不能翻”“是否匹配”“是否胜利”都在板对象里判断对话框只负责把结果画出来。// Card.h一张牌只关心自己的身份和显示状态 struct CCard { int nFaceId; // 配对用的图案编号两张相同即一对 int nRow; // 所在行 int nCol; // 所在列 CRect rcCell; // 在客户区中的绘制矩形 enum State { Hidden, Revealed, Matched } state; CCard() : nFaceId(-1), nRow(0), nCol(0), state(Hidden) {} }; // GameBoard.h规则层不碰 CDC也不碰窗口句柄 class CGameBoard { public: void Init(int nRows, int nCols); // 生成成对牌并洗牌 bool Flip(int nIndex); // 翻牌返回是否允许 bool CheckMatch(); // 判断当前两张是否配对 bool IsWin() const; // 是否全部匹配 private: std::vectorCCard m_cards; int m_nFirstIndex; int m_nSecondIndex; int m_nMatchedPairs; };CCard::nFaceId是配对依据不是数组下标rcCell让绘制和命中检测共用同一套矩形避免“画在这里、点在那里”。CGameBoard::Flip返回布尔值对话框根据返回值决定要不要刷新界面、要不要启动回翻定时器。把规则层和 MFC 的CDC、CWnd隔开后面加难度、换皮肤、写单元测试都容易得多。我一般会要求规则层不#include afxwin.h只依赖标准库和少量几何类型这样逻辑能单独跑。消息流向也顺了用户点击 -CGameDlg::OnLButtonDown把点坐标转成牌索引 - 调m_board.Flip(index)- 如果翻了两张且不匹配SetTimer等 800 毫秒 -OnTimer里调m_board回翻 -Invalidate触发OnPaint重画。每一步只做一件事调试时断点也好下。2.3 资源与配置图片、光标、字体和字符集牌面图片通常以位图资源形式放在res目录资源脚本里用IDB_CARD_01到IDB_CARD_N这类 ID 引用。代码里加载位图一般用CBitmap::LoadBitmap或CImage::Load。前者依赖资源 ID后者常用来读外部 PNG。单机小游戏为了分发方便我倾向于把图片编进资源不依赖运行目录下的相对路径。// 在对话框初始化时加载牌背和牌面 BOOL CGameDlg::LoadCardBitmaps() { if (!m_bmpBack.LoadBitmap(IDB_CARD_BACK)) { AfxMessageBox(_T(牌背位图加载失败检查资源 ID)); return FALSE; } for (int i 0; i CARD_KIND_COUNT; i) { if (!m_bmpFaces[i].LoadBitmap(IDB_CARD_01 i)) { AfxMessageBox(_T(牌面位图加载失败)); return FALSE; } } return TRUE; }LoadBitmap的参数是资源 ID返回值是BOOL失败时返回FALSE但很多示例代码不判断结果后面SelectObject选进内存 DC 的是空句柄界面直接黑块。IDB_CARD_01 i这种连续 ID 写法依赖资源脚本里 ID 连续改资源时容易断稳妥做法是建一个IDB_CARD_IDS[]数组逐项列出。字符集方面如果工程是 UnicodeCString和_T()保持一致如果老代码混用char*和CString编译期就会在LPCTSTR转换处报错别硬转统一到CString或std::wstring更省事。3. 核心模块拆解洗牌、翻牌、匹配与计分怎么落到代码3.1 卡牌数据结构与牌堆初始化记忆翻牌游戏的牌堆生成规则不复杂总牌数必须是偶数每张图案出现两次生成后打乱顺序。难点在“打乱”不能每次一样也不能让相邻牌总是成对。常见做法是先生成成对数组再用 Fisher-Yates 洗牌从后往前交换。随机种子用srand((unsigned)time(nullptr))在程序启动时播一次别在每次洗牌时播种否则同一秒内开局牌序会重复。void CGameBoard::Init(int nRows, int nCols) { const int nTotal nRows * nCols; ASSERT(nTotal % 2 0); // 牌数必须是偶数 m_cards.clear(); m_cards.resize(nTotal); // 先生成成对图案0,0,1,1,2,2... for (int i 0; i nTotal / 2; i) { m_cards[i * 2].nFaceId i; m_cards[i * 2 1].nFaceId i; } // Fisher-Yates 洗牌从后往前换 for (int i nTotal - 1; i 0; --i) { int j rand() % (i 1); std::swap(m_cards[i], m_cards[j]); } // 回填行列和绘制矩形 for (int i 0; i nTotal; i) { m_cards[i].nRow i / nCols; m_cards[i].nCol i % nCols; m_cards[i].state CCard::Hidden; m_cards[i].rcCell CRect( MARGIN m_cards[i].nCol * (CARD_W GAP), MARGIN m_cards[i].nRow * (CARD_H GAP), MARGIN m_cards[i].nCol * (CARD_W GAP) CARD_W, MARGIN m_cards[i].nRow * (CARD_H GAP) CARD_H); } m_nFirstIndex m_nSecondIndex -1; m_nMatchedPairs 0; }nTotal % 2 0这个断言别省改成 3x3 时总牌数是奇数成对生成会越界。rand() % (i 1)的范围是[0, i]符合 Fisher-Yates 的要求如果写成rand() % nTotal洗牌分布会偏。rcCell用行号列号算MARGIN、CARD_W、GAP建议做成常量或配置项后面换难度只改这几个数。m_nMatchedPairs用来判断胜利匹配一对加一等于nTotal / 2时结束。3.2 翻牌交互鼠标命中检测与状态机翻牌交互的核心不是“点哪张翻哪张”而是“什么时候不允许翻”。已经翻开的牌不能重复翻已经匹配的牌不能再点正在等待回翻的 800 毫秒内不能翻第三张。这些约束用一个状态机加一个m_bLock就能管住。命中检测用PtInRect遍历每张牌的rcCell找到索引后交给规则层。void CGameDlg::OnLButtonDown(UINT nFlags, CPoint point) { if (m_bGameOver || m_bLock) return; // 游戏结束或等待回翻时锁住 int nHit -1; for (int i 0; i (int)m_board.GetCardCount(); i) { if (m_board.GetCard(i).rcCell.PtInRect(point)) { nHit i; break; } } if (nHit -1) return; // 点空白区域不处理 if (!m_board.Flip(nHit)) return; // 已翻开或已匹配规则层拒绝 InvalidateRect(m_board.GetCard(nHit).rcCell, FALSE); if (m_board.HasTwoRevealed()) { if (m_board.CheckMatch()) { m_board.MarkMatched(); m_nPairsMatched m_board.GetMatchedPairs(); if (m_board.IsWin()) { KillTimer(TIMER_GAME); m_bGameOver TRUE; AfxMessageBox(_T(全部配对完成)); } Invalidate(); } else { m_bLock TRUE; SetTimer(TIMER_FLIP_BACK, 800, nullptr); // 800ms 后回翻 } } }point是客户区坐标PtInRect直接用它如果窗口有滚动条或做了缩放要先换算。m_bLock在翻第二张不匹配时置TRUEOnTimer回翻后复位防止用户连点翻出第三张。InvalidateRect只刷新被点的那张牌比整窗Invalidate省一点重绘但匹配后两张都要变所以直接整窗刷新。SetTimer的第三个参数是毫秒nullptr表示用默认回调实际走OnTimer。3.3 匹配判定、延时回翻与计分计时匹配判断只比较nFaceId相等就把两张牌状态置为Matched不等就回翻成Hidden。计时器建议分开一个TIMER_GAME每秒走一次更新用时一个TIMER_FLIP_BACK只负责回翻触发后立刻KillTimer避免重复排队。计分可以用“步数 用时”也可以加连击但连击逻辑要放在匹配成功分支里别和回翻定时器搅在一起。void CGameDlg::OnTimer(UINT_PTR nIDEvent) { if (nIDEvent TIMER_GAME) { m_nSeconds; CString s; s.Format(_T(用时%d 秒 步数%d), m_nSeconds, m_nSteps); m_staticStatus.SetWindowText(s); } else if (nIDEvent TIMER_FLIP_BACK) { KillTimer(TIMER_FLIP_BACK); // 先停掉防止重复触发 m_board.ResetRevealed(); // 两张非匹配牌翻回去 m_bLock FALSE; // 解锁允许下一次点击 Invalidate(); } CDialogEx::OnTimer(nIDEvent); }OnTimer里一定要先判断nIDEvent再分别处理最后调基类版本避免框架内部定时器被吞。KillTimer放在回翻分支开头是因为SetTimer同一个 ID 重复设置会覆盖但不主动停掉容易在快速点击时堆积。m_nSteps建议在每次成功翻开第一张时加一而不是每次点击都加否则点空白也计步玩家会觉得统计不准。计时器 ID 用常量或枚举别在代码里散落1、2。3.4 绘制与重绘OnPaint 里怎么画牌不闪MFC 默认绘制会先擦背景再画内容翻牌频繁刷新时容易闪。常见做法是双缓冲在内存 DC 里把背景、牌面、状态栏全画完再一次性BitBlt到窗口 DC。OnEraseBkgnd返回TRUE告诉框架背景不用默认擦除减少一次填充。void CGameDlg::OnPaint() { CPaintDC dc(this); CRect rcClient; GetClientRect(rcClient); CDC memDC; memDC.CreateCompatibleDC(dc); CBitmap bmp; bmp.CreateCompatibleBitmap(dc, rcClient.Width(), rcClient.Height()); CBitmap* pOld memDC.SelectObject(bmp); memDC.FillSolidRect(rcClient, RGB(30, 30, 30)); for (int i 0; i (int)m_board.GetCardCount(); i) { const CCard card m_board.GetCard(i); if (card.state CCard::Hidden) memDC.DrawState(card.rcCell.TopLeft(), CSize(CARD_W, CARD_H), m_bmpBack, DST_BITMAP); else memDC.DrawState(card.rcCell.TopLeft(), CSize(CARD_W, CARD_H), m_bmpFaces[card.nFaceId], DST_BITMAP); } dc.BitBlt(0, 0, rcClient.Width(), rcClient.Height(), memDC, 0, 0, SRCCOPY); memDC.SelectObject(pOld); }CreateCompatibleDC和CreateCompatibleBitmap创建的 GDI 对象必须成对释放SelectObject选回去之后局部CBitmap析构才会真正释放。DrawState的第二个参数是目标尺寸和rcCell的宽高保持一致如果图片比例不对牌面会拉伸。BitBlt的SRCCOPY表示直接拷贝颜色。双缓冲不是必须但翻牌游戏每点一次就重绘没有它体验会很差。4. 把项目跑起来编译配置、资源路径与第一局调试4.1 VS 打开工程后的三项检查平台工具集、MFC 库、字符集用 VS 打开.sln后先别急着编译。右键解决方案选择“重定解决方案目标”把平台工具集切到本机已安装的版本。然后打开项目属性检查三项配置属性 - 高级 - 字符集是 Unicode 还是多字节配置属性 - 常规 - MFC 的使用是“在共享 DLL 中使用 MFC”还是“在静态库中使用 MFC”C/C - 语言 - C 语言标准老工程常用默认值别一上来改到最新。如果编译报“无法打开包括文件 afxwin.h”基本是 MFC 组件没装或项目属性里 MFC 使用方式选错。共享 DLL 方式要求目标机器有对应运行库静态库方式体积大但分发省事。字符集不一致的典型报错是CString转const char*失败或者资源里的中文变成乱码。下面这段是.vcxproj里常见的配置片段改之前先备份PropertyGroup Condition$(Configuration)|$(Platform)Debug|Win32 CharacterSetUnicode/CharacterSet UseOfMfcDynamic/UseOfMfc /PropertyGroupCharacterSet为Unicode时_T(文本)会展开成宽字符UseOfMfc为Dynamic表示共享 DLL改成Static则静态链接。改完记得所有配置Debug/Release、Win32/x64都过一遍只改 Debug 会出现“调试能跑、发布报错”的经典局面。4.2 资源 ID 与图片加载为什么你的牌面显示成黑块牌面黑块通常不是绘图代码错而是位图没加载成功。先打开资源视图看IDB_CARD_BACK、IDB_CARD_01这些 ID 是否存在值和代码里是否一致。资源 ID 重名或手动改过resource.h后没重新生成LoadBitmap会返回FALSE。再一个常见原因是位图格式资源编辑器能导入 24 位、32 位位图但某些老代码用LoadBitmap加载 32 位带 Alpha 的图DrawState画出来可能偏色或黑底。// 加载后立刻判断别等到绘制时才发现空句柄 if (!m_bmpBack.LoadBitmap(IDB_CARD_BACK)) { TRACE(_T(LoadBitmap IDB_CARD_BACK failed, err%d\n), GetLastError()); return FALSE; }TRACE只在 Debug 下输出GetLastError()能辅助判断是资源找不到还是 GDI 失败。如果图片放在外部目录别用相对路径.\\res\\card.png因为调试时工作目录可能是项目目录直接运行 exe 时又变成 exe 目录。稳妥做法是用GetModuleFileName取 exe 路径再拼资源目录或者干脆把图片编进资源。4.3 单步调试一局用断点看翻牌状态怎么变第一局调试别靠肉眼盯界面直接下断点。在OnLButtonDown的m_board.Flip(nHit)前看nHit是不是预期索引在CheckMatch里看m_nFirstIndex和m_nSecondIndex是否指向两张不同牌在OnTimer回翻分支看m_bLock是否从TRUE变回FALSE。如果点第一张牌时nHit一直是-1多半是rcCell没初始化或者坐标偏移。// 临时调试输出确认状态流转 TRACE(_T(flip index%d, first%d, second%d, matched%d\n), nHit, m_board.GetFirstIndex(), m_board.GetSecondIndex(), m_board.GetMatchedPairs());TRACE输出到 VS 的“输出”窗口Release 下不编译不会拖性能。看输出时重点盯三件事翻第一张后first是否有值翻第二张后second是否和first不同回翻后matched是否只增不减。状态字段乱跳基本就是某处直接改了成员变量没走规则层。4.4 发布版与调试版的差异Release 下要注意什么Debug 能跑、Release 崩溃在老 MFC 工程里太常见。第一类是未初始化成员Debug 下堆栈可能碰巧是 0Release 下是随机值指针或索引直接越界。第二类是ASSERT里的表达式Release 下ASSERT被编译掉如果表达式里带了函数调用逻辑就少了半步。第三类是 GDI 对象泄漏Debug 下不明显Release 长时间运行后句柄耗尽。第四类是字符集和资源 ID 在两种配置下不一致。处理办法不玄学构造函数里把所有成员初始化数组访问前判断范围LoadBitmap、CreateCompatibleDC的返回值都检查定时器在OnDestroy里KillTimer。发布前用 Release 跑三局最小化再恢复快速连点基本能把大部分问题逼出来。5. 避坑与排查翻牌游戏最容易翻车的五个地方5.1 现象点击牌面没反应坐标总是偏移现象鼠标明明点在牌上nHit却是-1或者点第一张牌翻的是旁边那张。原因OnLButtonDown收到的point是客户区坐标但计算rcCell时混用了屏幕坐标窗口有边框、菜单栏或 DPI 缩放时偏移更明显。另一种情况是rcCell在OnPaint里按绘制尺寸算而命中检测用了另一套尺寸两边对不上。解决统一用客户区坐标。GetClientRect拿客户区大小棋盘左上角从(MARGIN, MARGIN)开始算PtInRect直接用point。如果确实拿到屏幕坐标先ScreenToClient(point)。高 DPI 下别写死像素按客户区宽度和行列数动态算CARD_W、CARD_H至少保证绘制和命中共用同一个rcCell。调试时把point和每张牌的rcCell打到输出窗口一眼就能看出偏多少。5.2 现象翻第二张后程序卡死或所有牌乱翻现象点完两张不匹配的牌界面不再响应或者等待回翻期间再点一下第三张、第四张全被翻开。原因m_bLock只置TRUE没复位或者OnTimer里KillTimer漏了回翻定时器反复触发也可能是SetTimer每次点击都设一个新 ID旧定时器还在跑。解决翻第二张不匹配时置锁OnTimer回翻分支第一行KillTimer(TIMER_FLIP_BACK)然后ResetRevealed、解锁、刷新。定时器 ID 用枚举别用魔法数字。快速连点测试时如果状态还乱在Flip里加一句“已有两张翻开则拒绝”让规则层兜底。5.3 现象图片显示为黑块或花屏现象牌背能显示牌面全是黑块或者窗口拉伸后牌面花屏。原因LoadBitmap返回FALSE没判断空句柄选进 DC位图颜色深度和 DC 不兼容DrawState的目标尺寸和源图比例差太多双缓冲的CBitmap没选回旧对象就析构。解决加载后立刻判断返回值失败就弹提示并退出初始化。双缓冲里SelectObject选入画完SelectObject(pOld)选回。牌面统一用同一种尺寸的位图绘制时按rcCell宽高等比缩放别让 GDI 硬拉伸。资源 ID 连续写法要核对断号就会加载到错误图片。5.4 现象最小化再恢复牌面消失或闪烁现象窗口最小化再还原牌面全黑或者整窗闪一下才恢复。原因OnPaint只画了部分牌依赖上次残留的窗口内容OnEraseBkgnd返回FALSE框架擦背景和自绘打架双缓冲位图尺寸没跟着客户区变化。解决OnPaint里每帧从背景到所有牌完整画一遍不依赖残留。OnEraseBkgnd返回TRUE背景在内存 DC 里填。窗口大小变化时重建双缓冲位图或者在OnSize里调Invalidate。最小化恢复本质是一次重绘绘制逻辑完整就不会丢牌。5.5 现象Release 能编译但运行时崩溃Debug 正常现象Debug 下玩得好好的Release 一运行就崩或者玩几局后崩。原因成员变量没初始化Release 下拿到随机值ASSERT里的副作用被优化掉GDI 对象或定时器没释放数组越界在 Debug 下被填充字节掩盖。解决构造函数初始化所有成员容器用std::vector并检查索引范围ASSERT只放纯判断别放函数调用OnDestroy里KillTimerGDI 对象成对创建释放发布前用 Release 跑快速连点、最小化恢复、连续开局三条路径。崩溃转储能抓就抓抓不到就在关键函数入口加日志。6. 二次开发从能玩到能改三条改造路线和验证方法第一条路线是难度配置。把行列数、回翻延时、是否显示倒计时抽成结构体别散在代码里struct GameConfig { int nRows 4; int nCols 4; int nFlipBackMs 800; bool bShowTimer true; };nRows * nCols必须为偶数初始化时断言nFlipBackMs改小会提高难度但低于 300 毫秒玩家看不清牌面。第二条路线是换皮肤把IDB_CARD_*换成同尺寸位图资源 ID 用数组映射别依赖连续 ID。第三条路线是把规则层抽出来写测试固定随机种子构造已知牌序调Flip和CheckMatch断言匹配对数和状态变化。验证时别只看界面跑一组固定操作序列比对最终步数和匹配数比肉眼可靠。我踩过的坑是改完难度直接跑结果 3x3 总牌数奇数成对生成越界Debug 下断言拦住Release 下直接崩。从那以后我每次改棋盘参数都先把“总牌数是否为偶数”和“资源 ID 数量是否够”这两条检查跑一遍。希望帮到你。本文还有配套的精品资源点击获取