简介这是一份基于MFC技术实现的扫雷游戏完整源码包面向具备C基础、希望掌握Windows桌面开发的初中级学习者也可作为课程设计、MFC入门练习或GUI编程实践参考。压缩包共71个文件约2.7MB包含h与cpp源码、bmp和ico界面素材、rc资源脚本、dsp与dsw工程文件以及dll、obj、pdb、exe等编译运行和调试产物既能直接运行体验也方便重新编译、跟踪调试与二次改造。已有477人学习下载说明其对入门读者具有一定参考价值。源码围绕自定义对话框与自定义按钮类展开涵盖雷区随机生成、格子数字与雷标显示、鼠标点击和右键标记的消息映射、游戏计时与剩余雷数统计、胜负判定等核心逻辑配合位图资源、资源视图和VC6工程文件读者可对照源码理解MFC对窗口、控件、消息循环及资源管理的封装方式并在此基础上调整界面布局、难度参数或扩展排行榜等功能。1. 从一张老式笑脸窗口说起MFC扫雷程序能干什么扫雷这个界面简单的老游戏恰好把 MFC 的消息映射、资源脚本、GDI 绘图和定时器都串了起来。下载包是一套能编译的 MFC 扫雷源码双击生成的 exe 后会出现一个固定大小的雷区窗口左键翻开格子右键插旗左右键同时按下去可以执行和弦展开顶部有剩余雷数、计时和重开入口。它适合正在学 Windows 桌面开发、要做课程设计、想找一个“界面不花哨但逻辑完整”的 C 练手项目的人。我更愿意把它当成 MFC 的解剖样本窗口怎么收消息按钮和菜单怎么响应格子怎么画递归展开怎么控制边界计时器什么时候启动和停止。源码包不大但一条完整的交互链路都在里面改起来也容易看到效果。下面按“先看结构、再拆算法、跑起来、避坑、二次改造”的顺序往下走。2. 工程结构与消息流从资源脚本到雷区视图的骨架2.1 先看目录对话框工程里每个文件管什么我拆这类 MFC 扫雷包时第一眼不看代码先看工程文件和后缀。常见做法是基于 MFC 对话框工程主界面是一个CDialogEx派生类雷区可能用一组自绘按钮也可能用一个静态控件承载所有格子绘制。源码包里的文件名不一定完全一样但职责大致固定。下面这张表可以拿来对照你手上的包文件或目录常见内容改动优先级*.sln/*.vcxprojVisual Studio 解决方案和工程配置低先保证能打开*.rc对话框模板、菜单、按钮、静态文本等资源中改界面先动这里resource.h资源 ID 和控件 ID 定义中新增控件要同步*Dlg.h/*Dlg.cpp主对话框类消息映射、游戏状态、计时器高核心逻辑多在这里Cell.h/Cell.cpp格子数据结构、状态枚举、邻雷计数高算法扩展先动这里pch.h/stdafx.h预编译头MFC 和标准库包含低报错时再看res/图标、位图、光标等资源低换皮肤时再用如果包里没有单独的Cell类格子数据大概率是主对话框里的一个二维数组元素类型可能是int或自定义结构体。此时不要急着重构先把“行、列、雷数、翻开状态、标记状态、邻雷数”这几个字段找出来后面所有逻辑都围着它们转。工程配置里还要留意字符集老包常用多字节字符集新版本 Visual Studio 默认 Unicode字符串和控件文本可能出现编译错误或乱码。遇到CString与char*混用不要全工程替换先看项目属性里的“字符集”是否和源码年代匹配。资源脚本是第二个入口。打开.rc后能看到对话框的客户区大小、按钮位置、静态文本 ID以及菜单项。扫雷的雷区一般不是一个个真实按钮而是自绘区域所以资源里只会看到“重开按钮”“计时文本”“雷数文本”这类控件。真正画格子的地方在OnPaint或某个自绘控件的DrawItem里。把资源 ID 和消息映射对上是读这套源码最省时间的路径。2.2 消息映射是扫雷的骨架MFC 不靠重写窗口过程来收消息而是在类里写消息映射宏。扫雷需要处理的重头戏是鼠标按下、定时器、绘制和重开命令。下面这段映射表是这类工程里常见的骨架类名可能不同宏的写法可以直接对照BEGIN_MESSAGE_MAP(CMinesweeperDlg, CDialogEx) ON_WM_PAINT() ON_WM_LBUTTONDOWN() ON_WM_RBUTTONDOWN() ON_WM_LBUTTONDBLCLK() ON_WM_TIMER() ON_BN_CLICKED(IDC_RESTART, CMinesweeperDlg::OnBnClickedRestart) ON_COMMAND(IDM_LEVEL_BEGINNER, CMinesweeperDlg::OnLevelBeginner) ON_COMMAND(IDM_LEVEL_EXPERT, CMinesweeperDlg::OnLevelExpert) END_MESSAGE_MAP()这张表的作用是把 Windows 消息翻译成成员函数。ON_WM_PAINT()对应OnPaint()鼠标左键对应OnLButtonDown(UINT nFlags, CPoint point)定时器对应OnTimer(UINT_PTR nIDEvent)。ON_BN_CLICKED是按钮点击ON_COMMAND是菜单命令。读源码时如果发现“点了没反应”先回到这里看对应 ID 有没有映射再看资源里的 ID 是否一致。nFlags参数在鼠标消息里很关键。左键按下时它可能带MK_RBUTTON表示右键此刻也按着这就是双键和弦的入口。point是客户区坐标单位是像素不是格子行列。很多错位问题就出在把point直接当行列用。正确顺序是先拿到雷区绘制区域的左上角再减去偏移除以格子边长最后做边界判断。2.3 雷区数据模型优先于界面界面只是表现扫雷的胜负和展开都靠数据模型。下面这个结构体是我一般会先落下来的版本字段不多但够把大部分逻辑撑起来struct Cell { bool mine false; // 是否是雷 bool opened false; // 是否已翻开 bool flagged false; // 是否插旗 bool exploded false; // 是否是被点爆的雷 int adjacent 0; // 周围八格雷数 }; class CGameBoard { public: int rows 9; int cols 9; int mineCount 10; std::vectorCell cells; Cell At(int r, int c) { return cells[r * cols c]; } bool InRange(int r, int c) const { return r 0 r rows c 0 c cols; } };cells用一维数组存二维数据取下标时用r * cols c。这样在重置、复制、测试棋盘快照时比vectorvectorCell省心。adjacent不是翻开时才算而是在布雷完成后统一算一遍后面绘制数字和判断空白格可以直接读。exploded单独标记是为了游戏结束时把踩中的那颗雷画成红色而不是所有雷一个样子。参数上rows、cols、mineCount是难度配置不要散落在各个函数里。初学者常把9、9、10写死在OnPaint和OpenCell里改难度时漏一处就出现“界面 9 列、逻辑 16 列”的怪现象。把它们收进棋盘类或主对话框成员后面加中级、高级只是换三个数字。3. 核心算法拆解布雷、翻开与递归展开的完整链路3.1 布雷与邻雷计数随机种子和边界处理布雷最常见的错误是每局雷区一样根源在随机种子只初始化一次或者每次重置都用了相同的固定值。下面这段代码把布雷和邻雷计数放在一起使用标准库的随机数引擎避免rand()在不同平台上的分布差异void CGameBoard::Reset(int newRows, int newCols, int newMines) { rows newRows; cols newCols; mineCount newMines; cells.assign(rows * cols, Cell{}); std::vectorint index(rows * cols); std::iota(index.begin(), index.end(), 0); std::mt19937 rng(std::random_device{}()); std::shuffle(index.begin(), index.end(), rng); for (int i 0; i mineCount; i) { cells[index[i]].mine true; } for (int r 0; r rows; r) { for (int c 0; c cols; c) { int count 0; for (int dr -1; dr 1; dr) { for (int dc -1; dc 1; dc) { if (dr 0 dc 0) continue; int nr r dr; int nc c dc; if (InRange(nr, nc) At(nr, nc).mine) { count; } } } At(r, c).adjacent count; } } }index保存所有格子编号std::shuffle打乱后取前mineCount个作为雷位。这样不会重复布雷也不需要循环“随机到不重复为止”。std::random_device{}()每次重置都会参与种子实际运行时不同局面的差异更明显。mineCount要小于rows * cols否则会越界自定义难度时先在界面层拦住非法输入。邻雷计数是双重循环加八方向偏移。InRange负责边界避免角落格子访问到数组外。adjacent只统计雷不统计旗子旗子插错不影响数字。这里的时间复杂度是O(rows * cols * 8)9×9 和 16×16 的规模完全够用不需要做额外优化。有一种常见变体是“首点不踩雷”玩家第一次点击后再布雷并把首点及其周围排除。这个改动要在OpenCell第一次调用时判断棋盘是否已初始化不要直接在Reset里做。否则重开按钮和首点逻辑会互相打架。3.2 左键翻开与递归展开栈深度和访问标记翻开是扫雷的核心链路。点中雷要结束游戏点中数字格只开一格点中空白格要递归展开周围区域。下面这个版本把边界、旗子、已翻开状态都挡在前面void CMinesweeperDlg::OpenCell(int r, int c) { if (!m_board.InRange(r, c)) return; Cell cell m_board.At(r, c); if (cell.opened || cell.flagged) return; if (cell.mine) { cell.exploded true; GameOver(false); return; } cell.opened true; m_openedCount; if (cell.adjacent 0) { for (int dr -1; dr 1; dr) { for (int dc -1; dc 1; dc) { if (dr 0 dc 0) continue; OpenCell(r dr, c dc); } } } InvalidateCell(r, c); CheckWin(); }opened是递归的访问标记没有它空白格之间会互相递归到栈溢出。flagged挡住已插旗格避免玩家右键标记后被左键展开。exploded只在踩雷时置位GameOver(false)里统一停止计时器、翻开所有雷、更新界面。InvalidateCell不要写成整窗Invalidate()。递归展开几十个格子时每个格都触发一次全窗重绘画面会闪调试时也看不清。常见做法是算出一个矩形区域最后合并重绘或者用InvalidateRect只刷新当前格。MFC 的绘制消息会合并但递归里频繁调用仍然浪费。胜利判断放在CheckWin()里条件是已翻开格子数等于总格数减雷数。不要把“所有非雷格翻开”写成遍历每个格子判断opened那样在递归中间态容易误判。计数变量在每次成功翻开时加一逻辑更直接。3.3 右键标记、双键和弦与胜负判断右键负责插旗和取消旗双键和弦负责在数字格周围旗数等于数字时一次性展开周围格。先看右键void CMinesweeperDlg::OnRButtonDown(UINT nFlags, CPoint point) { int r -1, c -1; if (!HitTest(point, r, c)) { CDialogEx::OnRButtonDown(nFlags, point); return; } Cell cell m_board.At(r, c); if (!cell.opened) { cell.flagged !cell.flagged; m_flaggedCount cell.flagged ? 1 : -1; UpdateMineCounter(); InvalidateCell(r, c); } CDialogEx::OnRButtonDown(nFlags, point); }HitTest把客户区坐标转成行列失败时返回false。m_flaggedCount用来更新剩余雷数显示插旗加一取消减一。不要在绘制时临时统计旗子数量那样每次重绘都要遍历全盘。和弦的触发条件是左右键同时按下或者中键按下不同源码版本不一样。下面用左键消息里检测右键状态的方式void CMinesweeperDlg::OnLButtonDown(UINT nFlags, CPoint point) { int r -1, c -1; if (!HitTest(point, r, c)) { CDialogEx::OnLButtonDown(nFlags, point); return; } if (nFlags MK_RBUTTON) { Chord(r, c); } else { OpenCell(r, c); } CDialogEx::OnLButtonDown(nFlags, point); } void CMinesweeperDlg::Chord(int r, int c) { if (!m_board.InRange(r, c)) return; Cell center m_board.At(r, c); if (!center.opened || center.adjacent 0) return; int flagCount 0; for (int dr -1; dr 1; dr) { for (int dc -1; dc 1; dc) { if (dr 0 dc 0) continue; if (m_board.InRange(r dr, c dc) m_board.At(r dr, c dc).flagged) { flagCount; } } } if (flagCount ! center.adjacent) return; for (int dr -1; dr 1; dr) { for (int dc -1; dc 1; dc) { if (dr 0 dc 0) continue; OpenCell(r dr, c dc); } } }MK_RBUTTON是左键消息里的右键状态位。Chord先确认中心格已翻开且数字大于零再数周围旗子。旗数不等于数字就直接返回不展开。等于数字时逐个调用OpenCell其中如果旗子插错踩到雷会正常结束游戏这个行为和经典扫雷一致。GameOver里要做三件事停止计时器、翻开所有未翻开雷、禁用继续点击。停止计时器用KillTimer(1)翻开雷用遍历设置opened true禁用点击可以设一个m_gameOver标志在鼠标消息入口直接返回。重开时清空标志、重置计数、重新Reset并刷新整个雷区。4. 编译运行与调试从源码包到可玩程序的落地步骤4.1 环境准备与第一次编译这套源码依赖 Visual Studio 的 MFC 组件。新装 Visual Studio 时只勾“使用 C 的桌面开发”还不够右侧安装细节里要勾选“适用于最新 v143 生成工具的 C MFC”。如果打开工程后报Cannot open include file: afxwin.h基本就是 MFC 没装不需要去改代码。第一次编译按这个顺序走先用 Visual Studio 打开.sln在工具栏选Debug和x86然后生成解决方案。老工程可能只有 Win32 配置选x64会提示平台不存在这时不要强行改平台直接用x86。如果工程提示“升级项目工具集”先备份一份源码包再确认升级升级后重点看字符集和平台集。命令行编译可以这样跑msbuild Minesweeper.sln /p:ConfigurationDebug /p:Platformx86 /m/p:ConfigurationDebug指定调试配置/p:Platformx86指定 32 位平台/m允许并行编译。msbuild要在 Visual Studio 开发者命令提示符里执行普通命令行可能找不到。生成成功后exe 通常在Debug或x86/Debug目录下取决于工程配置。运行前检查三处对话框资源是否被正确加载控件 ID 是否和代码里的GetDlgItem对得上计时器 ID 是否重复。启动后如果窗口一闪就退优先看InitInstance里有没有创建主对话框以及DoModal的返回值。不要一上来就改业务代码先把空窗口跑出来。4.2 资源与控件ID的核对扫雷界面上的“剩余雷数”“计时”“重开”一般用静态文本和按钮。资源视图里双击对话框能看到控件 ID例如IDC_MINE_COUNT、IDC_TIMER、IDC_RESTART。代码里更新文本常用void CMinesweeperDlg::UpdateMineCounter() { CString text; text.Format(_T(%03d), m_board.mineCount - m_flaggedCount); SetDlgItemText(IDC_MINE_COUNT, text); }Format(_T(%03d))输出三位数剩余雷数不足三位补零和经典扫雷的显示习惯一致。SetDlgItemText按控件 ID 找窗口如果 ID 写错运行时不会崩溃只是文本不更新很容易误判为“计时器没走”。排查时用 Spy 看控件 ID或者在OnInitDialog里打印GetDlgItem(IDC_MINE_COUNT)是否为空。菜单难度项也要核对。资源里菜单项的 ID 是IDM_LEVEL_BEGINNER消息映射里就必须有ON_COMMAND(IDM_LEVEL_BEGINNER, ...)。如果点击菜单没反应先看资源 ID 是否重复再看消息映射是否写在BEGIN_MESSAGE_MAP和END_MESSAGE_MAP之间。resource.h被手动改过后重复 ID 会让两个命令互相抢消息这类问题在旧课程设计包里很常见。窗口大小和雷区绘制区域也要一起改。常见做法是给雷区留一个固定矩形格子边长 雷区宽度 / 列数。改难度时如果只改行列不改窗口格子会被压扁或者画到客户区外。把雷区矩形、格子边长、行列数放进同一个布局函数后面换皮肤时只改颜色不改坐标计算。4.3 调试入口日志、断点和棋盘快照扫雷的 bug 很多是“状态不对但界面看不出来”。我一般先加一个棋盘快照函数把雷、翻开、旗子、邻雷数打成矩阵崩溃或胜负判断异常时直接看快照void CMinesweeperDlg::DumpBoard() { for (int r 0; r m_board.rows; r) { CString line; for (int c 0; c m_board.cols; c) { const Cell cell m_board.At(r, c); TCHAR ch _T(.); if (cell.mine) ch _T(*); else if (cell.opened) ch _T(0) cell.adjacent; if (cell.flagged) ch _T(F); line ch; } TRACE(_T(%s\n), line); } TRACE(_T(opened%d mines%d flags%d\n), m_openedCount, m_board.mineCount, m_flaggedCount); }TRACE只在 Debug 配置输出Release 下会被编译掉。输出里*是雷.是未翻开数字是已翻开的邻雷数F是旗子。opened、mines、flags三个计数放在最后一行胜利条件不对时先看这三个数。断点不要只下在OpenCell开头递归展开时会被打断很多次在CheckWin和GameOver里下条件断点更有效。如果程序在 Release 下才崩优先查数组越界和未初始化。Cell的布尔字段要在构造时给默认值std::vectorCell的assign会值初始化但如果用的是new Cell[n]内置类型不会自动清零。坐标转换函数HitTest也要防负数point.x - offsetX为负时除以格子边长会得到 0 或负数直接拿去索引就出事。5. 避坑与排查MFC扫雷最容易翻车的五处细节5.1 每局雷区一样随机种子放错位置现象点重开之后雷的位置和上一局完全相同或者连续几局都很像。原因随机种子在OnInitDialog里只调了一次Reset里继续用同一个种子也有源码在每次重置时调用srand(time(NULL))但两次重置发生在同一秒内种子相同。解决把随机数引擎作为成员保存重置时用std::random_device重新播种或者用递增的局数参与种子。不要用rand() % n直接布雷重复雷位会让实际雷数少于配置值剩余雷数显示就会对不上。5.2 点格子错位客户区坐标、边框与DPI现象鼠标点在格子上翻开的却是旁边一格窗口放大后错位更明显。原因point是客户区坐标雷区绘制区域有左上角偏移代码里直接point.x / cellSize没有减偏移或者工程启用了 DPI 缩放绘制用逻辑像素鼠标消息用物理像素。解决把雷区矩形保存为成员HitTest里先判断点是否落在矩形内再减左上角坐标最后除以格子边长。高 DPI 下在清单文件里声明感知级别或者统一用GetClientRect重新计算布局。改完用四个角和中心点各点一次别只点中间。5.3 递归展开卡死或闪屏Invalidate调用太频繁现象点一个空白格后界面卡住或者格子一个个闪出来。原因递归展开没有opened访问标记空白格互相调用或者每翻开一格就Invalidate()整窗绘制消息堆积。解决在OpenCell开头挡opened和flagged递归只向八邻域走绘制用InvalidateRect限定当前格递归结束后再统一刷新一次状态栏。如果棋盘很大可以把递归改成显式栈避免深递归但 16×16 的规模通常不需要。5.4 右键菜单不弹、按钮没反应消息映射与ID冲突现象点重开按钮没反应点菜单难度也不切换但程序不报错。原因资源里的控件 ID 和代码里的 ID 不一致resource.h里两个 ID 值相同消息映射宏写在BEGIN_MESSAGE_MAP外面或者对话框类没有加DECLARE_MESSAGE_MAP()。解决在资源视图里复制控件 ID 到代码里搜索确认只有一处定义用ON_BN_CLICKED对按钮用ON_COMMAND对菜单改完清理解决方案再重编。MFC 的消息映射是编译期宏漏写不会在运行时报错只会表现为“点了没动静”。5.5 释放版本才崩数组越界与未初始化现象Debug 下能玩Release 下点几次就退出或者胜利时偶尔弹错。原因Cell数组用new分配后没清零adjacent是随机值HitTest返回的行列没有做边界检查递归展开到棋盘外。解决统一用std::vectorCell并assign初始化所有取格子前走InRangeHitTest失败返回false调用方直接返回。Release 下断言不生效边界判断要写成正式代码不要依赖ASSERT。6. 二次开发改造难度、皮肤与数据持久化怎么加加难度不要先改界面先把行列和雷数收进一个配置结构再用CWinApp的GetProfileInt/WriteProfileInt存到 ini 或注册表。常见做法是主对话框启动时读配置切换难度时写配置并重置棋盘。这样下一次打开程序还能保持上次选择调试时也可以手动改 ini 快速切到高级。皮肤改造从绘制函数下手把格子背景、翻开色、旗子色、数字色抽成主题结构DrawCell只读主题不写死颜色。想要不闪给雷区加双缓冲内存 DC 画完整棋盘再一次BitBlt到窗口。改完先别急着换素材用纯色主题验证坐标和状态再换位图。验证改造是否伤到逻辑我习惯加两个检查固定随机种子跑一局确认雷数和邻雷计数正确用DumpBoard在胜利、踩雷、重开三个时刻各打一次快照看opened和flagged是否归零。从那以后我每次拿到这类 MFC 源码都先跑原始版本、再改配置、最后动绘制顺序不乱。希望帮到你。本文还有配套的精品资源点击获取
简介这是一份基于MFC技术实现的扫雷游戏完整源码包面向具备C基础、希望掌握Windows桌面开发的初中级学习者也可作为课程设计、MFC入门练习或GUI编程实践参考。压缩包共71个文件约2.7MB包含h与cpp源码、bmp和ico界面素材、rc资源脚本、dsp与dsw工程文件以及dll、obj、pdb、exe等编译运行和调试产物既能直接运行体验也方便重新编译、跟踪调试与二次改造。已有477人学习下载说明其对入门读者具有一定参考价值。源码围绕自定义对话框与自定义按钮类展开涵盖雷区随机生成、格子数字与雷标显示、鼠标点击和右键标记的消息映射、游戏计时与剩余雷数统计、胜负判定等核心逻辑配合位图资源、资源视图和VC6工程文件读者可对照源码理解MFC对窗口、控件、消息循环及资源管理的封装方式并在此基础上调整界面布局、难度参数或扩展排行榜等功能。1. 从一张老式笑脸窗口说起MFC扫雷程序能干什么扫雷这个界面简单的老游戏恰好把 MFC 的消息映射、资源脚本、GDI 绘图和定时器都串了起来。下载包是一套能编译的 MFC 扫雷源码双击生成的 exe 后会出现一个固定大小的雷区窗口左键翻开格子右键插旗左右键同时按下去可以执行和弦展开顶部有剩余雷数、计时和重开入口。它适合正在学 Windows 桌面开发、要做课程设计、想找一个“界面不花哨但逻辑完整”的 C 练手项目的人。我更愿意把它当成 MFC 的解剖样本窗口怎么收消息按钮和菜单怎么响应格子怎么画递归展开怎么控制边界计时器什么时候启动和停止。源码包不大但一条完整的交互链路都在里面改起来也容易看到效果。下面按“先看结构、再拆算法、跑起来、避坑、二次改造”的顺序往下走。2. 工程结构与消息流从资源脚本到雷区视图的骨架2.1 先看目录对话框工程里每个文件管什么我拆这类 MFC 扫雷包时第一眼不看代码先看工程文件和后缀。常见做法是基于 MFC 对话框工程主界面是一个CDialogEx派生类雷区可能用一组自绘按钮也可能用一个静态控件承载所有格子绘制。源码包里的文件名不一定完全一样但职责大致固定。下面这张表可以拿来对照你手上的包文件或目录常见内容改动优先级*.sln/*.vcxprojVisual Studio 解决方案和工程配置低先保证能打开*.rc对话框模板、菜单、按钮、静态文本等资源中改界面先动这里resource.h资源 ID 和控件 ID 定义中新增控件要同步*Dlg.h/*Dlg.cpp主对话框类消息映射、游戏状态、计时器高核心逻辑多在这里Cell.h/Cell.cpp格子数据结构、状态枚举、邻雷计数高算法扩展先动这里pch.h/stdafx.h预编译头MFC 和标准库包含低报错时再看res/图标、位图、光标等资源低换皮肤时再用如果包里没有单独的Cell类格子数据大概率是主对话框里的一个二维数组元素类型可能是int或自定义结构体。此时不要急着重构先把“行、列、雷数、翻开状态、标记状态、邻雷数”这几个字段找出来后面所有逻辑都围着它们转。工程配置里还要留意字符集老包常用多字节字符集新版本 Visual Studio 默认 Unicode字符串和控件文本可能出现编译错误或乱码。遇到CString与char*混用不要全工程替换先看项目属性里的“字符集”是否和源码年代匹配。资源脚本是第二个入口。打开.rc后能看到对话框的客户区大小、按钮位置、静态文本 ID以及菜单项。扫雷的雷区一般不是一个个真实按钮而是自绘区域所以资源里只会看到“重开按钮”“计时文本”“雷数文本”这类控件。真正画格子的地方在OnPaint或某个自绘控件的DrawItem里。把资源 ID 和消息映射对上是读这套源码最省时间的路径。2.2 消息映射是扫雷的骨架MFC 不靠重写窗口过程来收消息而是在类里写消息映射宏。扫雷需要处理的重头戏是鼠标按下、定时器、绘制和重开命令。下面这段映射表是这类工程里常见的骨架类名可能不同宏的写法可以直接对照BEGIN_MESSAGE_MAP(CMinesweeperDlg, CDialogEx) ON_WM_PAINT() ON_WM_LBUTTONDOWN() ON_WM_RBUTTONDOWN() ON_WM_LBUTTONDBLCLK() ON_WM_TIMER() ON_BN_CLICKED(IDC_RESTART, CMinesweeperDlg::OnBnClickedRestart) ON_COMMAND(IDM_LEVEL_BEGINNER, CMinesweeperDlg::OnLevelBeginner) ON_COMMAND(IDM_LEVEL_EXPERT, CMinesweeperDlg::OnLevelExpert) END_MESSAGE_MAP()这张表的作用是把 Windows 消息翻译成成员函数。ON_WM_PAINT()对应OnPaint()鼠标左键对应OnLButtonDown(UINT nFlags, CPoint point)定时器对应OnTimer(UINT_PTR nIDEvent)。ON_BN_CLICKED是按钮点击ON_COMMAND是菜单命令。读源码时如果发现“点了没反应”先回到这里看对应 ID 有没有映射再看资源里的 ID 是否一致。nFlags参数在鼠标消息里很关键。左键按下时它可能带MK_RBUTTON表示右键此刻也按着这就是双键和弦的入口。point是客户区坐标单位是像素不是格子行列。很多错位问题就出在把point直接当行列用。正确顺序是先拿到雷区绘制区域的左上角再减去偏移除以格子边长最后做边界判断。2.3 雷区数据模型优先于界面界面只是表现扫雷的胜负和展开都靠数据模型。下面这个结构体是我一般会先落下来的版本字段不多但够把大部分逻辑撑起来struct Cell { bool mine false; // 是否是雷 bool opened false; // 是否已翻开 bool flagged false; // 是否插旗 bool exploded false; // 是否是被点爆的雷 int adjacent 0; // 周围八格雷数 }; class CGameBoard { public: int rows 9; int cols 9; int mineCount 10; std::vectorCell cells; Cell At(int r, int c) { return cells[r * cols c]; } bool InRange(int r, int c) const { return r 0 r rows c 0 c cols; } };cells用一维数组存二维数据取下标时用r * cols c。这样在重置、复制、测试棋盘快照时比vectorvectorCell省心。adjacent不是翻开时才算而是在布雷完成后统一算一遍后面绘制数字和判断空白格可以直接读。exploded单独标记是为了游戏结束时把踩中的那颗雷画成红色而不是所有雷一个样子。参数上rows、cols、mineCount是难度配置不要散落在各个函数里。初学者常把9、9、10写死在OnPaint和OpenCell里改难度时漏一处就出现“界面 9 列、逻辑 16 列”的怪现象。把它们收进棋盘类或主对话框成员后面加中级、高级只是换三个数字。3. 核心算法拆解布雷、翻开与递归展开的完整链路3.1 布雷与邻雷计数随机种子和边界处理布雷最常见的错误是每局雷区一样根源在随机种子只初始化一次或者每次重置都用了相同的固定值。下面这段代码把布雷和邻雷计数放在一起使用标准库的随机数引擎避免rand()在不同平台上的分布差异void CGameBoard::Reset(int newRows, int newCols, int newMines) { rows newRows; cols newCols; mineCount newMines; cells.assign(rows * cols, Cell{}); std::vectorint index(rows * cols); std::iota(index.begin(), index.end(), 0); std::mt19937 rng(std::random_device{}()); std::shuffle(index.begin(), index.end(), rng); for (int i 0; i mineCount; i) { cells[index[i]].mine true; } for (int r 0; r rows; r) { for (int c 0; c cols; c) { int count 0; for (int dr -1; dr 1; dr) { for (int dc -1; dc 1; dc) { if (dr 0 dc 0) continue; int nr r dr; int nc c dc; if (InRange(nr, nc) At(nr, nc).mine) { count; } } } At(r, c).adjacent count; } } }index保存所有格子编号std::shuffle打乱后取前mineCount个作为雷位。这样不会重复布雷也不需要循环“随机到不重复为止”。std::random_device{}()每次重置都会参与种子实际运行时不同局面的差异更明显。mineCount要小于rows * cols否则会越界自定义难度时先在界面层拦住非法输入。邻雷计数是双重循环加八方向偏移。InRange负责边界避免角落格子访问到数组外。adjacent只统计雷不统计旗子旗子插错不影响数字。这里的时间复杂度是O(rows * cols * 8)9×9 和 16×16 的规模完全够用不需要做额外优化。有一种常见变体是“首点不踩雷”玩家第一次点击后再布雷并把首点及其周围排除。这个改动要在OpenCell第一次调用时判断棋盘是否已初始化不要直接在Reset里做。否则重开按钮和首点逻辑会互相打架。3.2 左键翻开与递归展开栈深度和访问标记翻开是扫雷的核心链路。点中雷要结束游戏点中数字格只开一格点中空白格要递归展开周围区域。下面这个版本把边界、旗子、已翻开状态都挡在前面void CMinesweeperDlg::OpenCell(int r, int c) { if (!m_board.InRange(r, c)) return; Cell cell m_board.At(r, c); if (cell.opened || cell.flagged) return; if (cell.mine) { cell.exploded true; GameOver(false); return; } cell.opened true; m_openedCount; if (cell.adjacent 0) { for (int dr -1; dr 1; dr) { for (int dc -1; dc 1; dc) { if (dr 0 dc 0) continue; OpenCell(r dr, c dc); } } } InvalidateCell(r, c); CheckWin(); }opened是递归的访问标记没有它空白格之间会互相递归到栈溢出。flagged挡住已插旗格避免玩家右键标记后被左键展开。exploded只在踩雷时置位GameOver(false)里统一停止计时器、翻开所有雷、更新界面。InvalidateCell不要写成整窗Invalidate()。递归展开几十个格子时每个格都触发一次全窗重绘画面会闪调试时也看不清。常见做法是算出一个矩形区域最后合并重绘或者用InvalidateRect只刷新当前格。MFC 的绘制消息会合并但递归里频繁调用仍然浪费。胜利判断放在CheckWin()里条件是已翻开格子数等于总格数减雷数。不要把“所有非雷格翻开”写成遍历每个格子判断opened那样在递归中间态容易误判。计数变量在每次成功翻开时加一逻辑更直接。3.3 右键标记、双键和弦与胜负判断右键负责插旗和取消旗双键和弦负责在数字格周围旗数等于数字时一次性展开周围格。先看右键void CMinesweeperDlg::OnRButtonDown(UINT nFlags, CPoint point) { int r -1, c -1; if (!HitTest(point, r, c)) { CDialogEx::OnRButtonDown(nFlags, point); return; } Cell cell m_board.At(r, c); if (!cell.opened) { cell.flagged !cell.flagged; m_flaggedCount cell.flagged ? 1 : -1; UpdateMineCounter(); InvalidateCell(r, c); } CDialogEx::OnRButtonDown(nFlags, point); }HitTest把客户区坐标转成行列失败时返回false。m_flaggedCount用来更新剩余雷数显示插旗加一取消减一。不要在绘制时临时统计旗子数量那样每次重绘都要遍历全盘。和弦的触发条件是左右键同时按下或者中键按下不同源码版本不一样。下面用左键消息里检测右键状态的方式void CMinesweeperDlg::OnLButtonDown(UINT nFlags, CPoint point) { int r -1, c -1; if (!HitTest(point, r, c)) { CDialogEx::OnLButtonDown(nFlags, point); return; } if (nFlags MK_RBUTTON) { Chord(r, c); } else { OpenCell(r, c); } CDialogEx::OnLButtonDown(nFlags, point); } void CMinesweeperDlg::Chord(int r, int c) { if (!m_board.InRange(r, c)) return; Cell center m_board.At(r, c); if (!center.opened || center.adjacent 0) return; int flagCount 0; for (int dr -1; dr 1; dr) { for (int dc -1; dc 1; dc) { if (dr 0 dc 0) continue; if (m_board.InRange(r dr, c dc) m_board.At(r dr, c dc).flagged) { flagCount; } } } if (flagCount ! center.adjacent) return; for (int dr -1; dr 1; dr) { for (int dc -1; dc 1; dc) { if (dr 0 dc 0) continue; OpenCell(r dr, c dc); } } }MK_RBUTTON是左键消息里的右键状态位。Chord先确认中心格已翻开且数字大于零再数周围旗子。旗数不等于数字就直接返回不展开。等于数字时逐个调用OpenCell其中如果旗子插错踩到雷会正常结束游戏这个行为和经典扫雷一致。GameOver里要做三件事停止计时器、翻开所有未翻开雷、禁用继续点击。停止计时器用KillTimer(1)翻开雷用遍历设置opened true禁用点击可以设一个m_gameOver标志在鼠标消息入口直接返回。重开时清空标志、重置计数、重新Reset并刷新整个雷区。4. 编译运行与调试从源码包到可玩程序的落地步骤4.1 环境准备与第一次编译这套源码依赖 Visual Studio 的 MFC 组件。新装 Visual Studio 时只勾“使用 C 的桌面开发”还不够右侧安装细节里要勾选“适用于最新 v143 生成工具的 C MFC”。如果打开工程后报Cannot open include file: afxwin.h基本就是 MFC 没装不需要去改代码。第一次编译按这个顺序走先用 Visual Studio 打开.sln在工具栏选Debug和x86然后生成解决方案。老工程可能只有 Win32 配置选x64会提示平台不存在这时不要强行改平台直接用x86。如果工程提示“升级项目工具集”先备份一份源码包再确认升级升级后重点看字符集和平台集。命令行编译可以这样跑msbuild Minesweeper.sln /p:ConfigurationDebug /p:Platformx86 /m/p:ConfigurationDebug指定调试配置/p:Platformx86指定 32 位平台/m允许并行编译。msbuild要在 Visual Studio 开发者命令提示符里执行普通命令行可能找不到。生成成功后exe 通常在Debug或x86/Debug目录下取决于工程配置。运行前检查三处对话框资源是否被正确加载控件 ID 是否和代码里的GetDlgItem对得上计时器 ID 是否重复。启动后如果窗口一闪就退优先看InitInstance里有没有创建主对话框以及DoModal的返回值。不要一上来就改业务代码先把空窗口跑出来。4.2 资源与控件ID的核对扫雷界面上的“剩余雷数”“计时”“重开”一般用静态文本和按钮。资源视图里双击对话框能看到控件 ID例如IDC_MINE_COUNT、IDC_TIMER、IDC_RESTART。代码里更新文本常用void CMinesweeperDlg::UpdateMineCounter() { CString text; text.Format(_T(%03d), m_board.mineCount - m_flaggedCount); SetDlgItemText(IDC_MINE_COUNT, text); }Format(_T(%03d))输出三位数剩余雷数不足三位补零和经典扫雷的显示习惯一致。SetDlgItemText按控件 ID 找窗口如果 ID 写错运行时不会崩溃只是文本不更新很容易误判为“计时器没走”。排查时用 Spy 看控件 ID或者在OnInitDialog里打印GetDlgItem(IDC_MINE_COUNT)是否为空。菜单难度项也要核对。资源里菜单项的 ID 是IDM_LEVEL_BEGINNER消息映射里就必须有ON_COMMAND(IDM_LEVEL_BEGINNER, ...)。如果点击菜单没反应先看资源 ID 是否重复再看消息映射是否写在BEGIN_MESSAGE_MAP和END_MESSAGE_MAP之间。resource.h被手动改过后重复 ID 会让两个命令互相抢消息这类问题在旧课程设计包里很常见。窗口大小和雷区绘制区域也要一起改。常见做法是给雷区留一个固定矩形格子边长 雷区宽度 / 列数。改难度时如果只改行列不改窗口格子会被压扁或者画到客户区外。把雷区矩形、格子边长、行列数放进同一个布局函数后面换皮肤时只改颜色不改坐标计算。4.3 调试入口日志、断点和棋盘快照扫雷的 bug 很多是“状态不对但界面看不出来”。我一般先加一个棋盘快照函数把雷、翻开、旗子、邻雷数打成矩阵崩溃或胜负判断异常时直接看快照void CMinesweeperDlg::DumpBoard() { for (int r 0; r m_board.rows; r) { CString line; for (int c 0; c m_board.cols; c) { const Cell cell m_board.At(r, c); TCHAR ch _T(.); if (cell.mine) ch _T(*); else if (cell.opened) ch _T(0) cell.adjacent; if (cell.flagged) ch _T(F); line ch; } TRACE(_T(%s\n), line); } TRACE(_T(opened%d mines%d flags%d\n), m_openedCount, m_board.mineCount, m_flaggedCount); }TRACE只在 Debug 配置输出Release 下会被编译掉。输出里*是雷.是未翻开数字是已翻开的邻雷数F是旗子。opened、mines、flags三个计数放在最后一行胜利条件不对时先看这三个数。断点不要只下在OpenCell开头递归展开时会被打断很多次在CheckWin和GameOver里下条件断点更有效。如果程序在 Release 下才崩优先查数组越界和未初始化。Cell的布尔字段要在构造时给默认值std::vectorCell的assign会值初始化但如果用的是new Cell[n]内置类型不会自动清零。坐标转换函数HitTest也要防负数point.x - offsetX为负时除以格子边长会得到 0 或负数直接拿去索引就出事。5. 避坑与排查MFC扫雷最容易翻车的五处细节5.1 每局雷区一样随机种子放错位置现象点重开之后雷的位置和上一局完全相同或者连续几局都很像。原因随机种子在OnInitDialog里只调了一次Reset里继续用同一个种子也有源码在每次重置时调用srand(time(NULL))但两次重置发生在同一秒内种子相同。解决把随机数引擎作为成员保存重置时用std::random_device重新播种或者用递增的局数参与种子。不要用rand() % n直接布雷重复雷位会让实际雷数少于配置值剩余雷数显示就会对不上。5.2 点格子错位客户区坐标、边框与DPI现象鼠标点在格子上翻开的却是旁边一格窗口放大后错位更明显。原因point是客户区坐标雷区绘制区域有左上角偏移代码里直接point.x / cellSize没有减偏移或者工程启用了 DPI 缩放绘制用逻辑像素鼠标消息用物理像素。解决把雷区矩形保存为成员HitTest里先判断点是否落在矩形内再减左上角坐标最后除以格子边长。高 DPI 下在清单文件里声明感知级别或者统一用GetClientRect重新计算布局。改完用四个角和中心点各点一次别只点中间。5.3 递归展开卡死或闪屏Invalidate调用太频繁现象点一个空白格后界面卡住或者格子一个个闪出来。原因递归展开没有opened访问标记空白格互相调用或者每翻开一格就Invalidate()整窗绘制消息堆积。解决在OpenCell开头挡opened和flagged递归只向八邻域走绘制用InvalidateRect限定当前格递归结束后再统一刷新一次状态栏。如果棋盘很大可以把递归改成显式栈避免深递归但 16×16 的规模通常不需要。5.4 右键菜单不弹、按钮没反应消息映射与ID冲突现象点重开按钮没反应点菜单难度也不切换但程序不报错。原因资源里的控件 ID 和代码里的 ID 不一致resource.h里两个 ID 值相同消息映射宏写在BEGIN_MESSAGE_MAP外面或者对话框类没有加DECLARE_MESSAGE_MAP()。解决在资源视图里复制控件 ID 到代码里搜索确认只有一处定义用ON_BN_CLICKED对按钮用ON_COMMAND对菜单改完清理解决方案再重编。MFC 的消息映射是编译期宏漏写不会在运行时报错只会表现为“点了没动静”。5.5 释放版本才崩数组越界与未初始化现象Debug 下能玩Release 下点几次就退出或者胜利时偶尔弹错。原因Cell数组用new分配后没清零adjacent是随机值HitTest返回的行列没有做边界检查递归展开到棋盘外。解决统一用std::vectorCell并assign初始化所有取格子前走InRangeHitTest失败返回false调用方直接返回。Release 下断言不生效边界判断要写成正式代码不要依赖ASSERT。6. 二次开发改造难度、皮肤与数据持久化怎么加加难度不要先改界面先把行列和雷数收进一个配置结构再用CWinApp的GetProfileInt/WriteProfileInt存到 ini 或注册表。常见做法是主对话框启动时读配置切换难度时写配置并重置棋盘。这样下一次打开程序还能保持上次选择调试时也可以手动改 ini 快速切到高级。皮肤改造从绘制函数下手把格子背景、翻开色、旗子色、数字色抽成主题结构DrawCell只读主题不写死颜色。想要不闪给雷区加双缓冲内存 DC 画完整棋盘再一次BitBlt到窗口。改完先别急着换素材用纯色主题验证坐标和状态再换位图。验证改造是否伤到逻辑我习惯加两个检查固定随机种子跑一局确认雷数和邻雷计数正确用DumpBoard在胜利、踩雷、重开三个时刻各打一次快照看opened和flagged是否归零。从那以后我每次拿到这类 MFC 源码都先跑原始版本、再改配置、最后动绘制顺序不乱。希望帮到你。本文还有配套的精品资源点击获取
