简介这是一份面向Windows程序设计初学者与MFC进阶开发者的扫雷游戏完整源码工程基于Microsoft Foundation Classes框架实现帮助读者理解如何用C类库封装Win32 API、构建图形界面并处理消息循环。压缩包共71个文件约2.7MB包含7个cpp源文件与8个h头文件承载核心逻辑26个bmp位图与2个ico图标构成界面素材另有rc资源脚本、dsp/dsw工程文件及exe可执行程序可直接编译运行或对照调试。资源围绕雷区随机生成、CButton格子交互、计时统计、CDialog主界面布局与消息映射等模块展开源码中CMyDialog负责整体事件处理CMyButton定制单格行为便于读者梳理MFC消息机制与游戏逻辑的结合方式。目前已有475人学习下载适合作为课程设计、Windows编程练手或MFC框架入门的实践参考。1. 扫雷这游戏用MFC写一遍才知道坑在哪很多人第一次接触Windows桌面开发都是从扫雷这类小游戏开始的。看着简单一个网格、几个数字、左右键点一点但真动手用MFC写一遍你会发现消息映射、GDI绘图、定时器、递归展开这些机制一个都绕不开。这份源码就是一个完整的MFC扫雷实现包含工程文件和全部代码适合想学MFC但不知道拿什么练手的开发者也适合想拆解经典游戏逻辑的人。它不依赖任何第三方库纯Win32 API加MFC框架编译出来就是一个能跑的exe。下面我从工程结构、核心模块、编译运行到二次开发把这份源码拆开讲一遍。2. 工程结构与技术选型为什么是MFC而不是Qt2.1 目录里有什么拿到源码包第一件事是看目录结构。这个项目的组织方式很典型是Visual Studio的MFC应用程序向导生成的骨架然后在此基础上填充游戏逻辑。大致结构如下MineSweeper/ ├── MineSweeper.sln # VS解决方案文件 ├── MineSweeper/ │ ├── MineSweeper.h # 主头文件包含资源ID和全局定义 │ ├── MineSweeper.cpp # 应用程序入口InitInstance在这里 │ ├── MainFrm.h/.cpp # 主框架窗口类 │ ├── MineSweeperView.h/.cpp # 视图类游戏主逻辑所在 │ ├── MineSweeperDoc.h/.cpp # 文档类管理游戏数据 │ ├── resource.h # 资源ID定义 │ ├── res/ # 图标、菜单、位图等资源 │ └── stdafx.h/.cpp # 预编译头这是标准的MFC文档/视图架构。文档类负责存数据视图类负责画界面和响应输入。对于扫雷这种单窗口游戏来说文档/视图有点重但好处是数据与显示分离后面改起来清晰。2.2 为什么选MFC现在做Windows桌面开发Qt、Electron、WPF都是更主流的选择。但MFC有它的场景体积小、启动快、不依赖运行时库、直接调用Win32 API。这个扫雷项目编译出来大概几百KB双击就能跑不需要装任何东西。如果你维护的是老项目或者需要嵌入到已有的MFC系统里MFC就是最自然的选择。技术栈上这个项目用了MFC 4.2以上VS2010到VS2022都能编译GDI绘图用CDC类画网格、数字、雷区消息映射ON_WM_LBUTTONDOWN、ON_WM_RBUTTONDOWN处理鼠标定时器SetTimer做计时功能递归算法空白区域自动展开没有用GDI没有用DirectX全是基础API。这意味着代码可读性高但绘图效率一般。对于9x9到16x30的棋盘完全够用。2.3 核心数据结构游戏的数据模型不复杂但设计得好不好直接影响后面写逻辑的难度。这个项目用了两个二维数组来存状态// MineSweeperDoc.h 中的核心数据成员 class CMineSweeperDoc : public CDocument { protected: int m_nRows; // 行数 int m_nCols; // 列数 int m_nMines; // 雷的总数 int m_nFlags; // 已插旗数量 int m_nRemainMines; // 剩余雷数用于显示 BOOL m_bGameOver; // 游戏是否结束 BOOL m_bWin; // 是否胜利 // 核心数据每个格子的状态 // -1表示雷0-8表示周围雷数 int** m_pMineMap; // 每个格子的显示状态 // 0未翻开, 1已翻开, 2插旗, 3问号 int** m_pStateMap; // 记录哪些格子已经被翻开过用于递归展开 BOOL** m_pRevealed; };m_pMineMap存的是逻辑数据这个格子是不是雷周围有几颗雷。m_pStateMap存的是显示状态玩家看到的是未翻开、已翻开还是插了旗。两个数组分开的好处是重置游戏时只需要重新生成m_pMineMap显示状态统一清零就行。用int**而不是vectorvectorint是因为MFC项目通常不鼓励用STL而且二维指针在内存上是连续的访问效率高。但要注意在构造函数里分配析构函数里释放否则会内存泄漏。3. 核心模块拆解从布雷到递归展开的完整链路3.1 布雷算法第一下不能踩雷扫雷有个基本体验要求第一次点击不能踩雷。这个项目怎么做的不是在初始化时就布好雷而是等玩家第一次左键点击后再根据点击位置布雷。// MineSweeperDoc.cpp void CMineSweeperDoc::PlaceMines(int nFirstRow, int nFirstCol) { // 先清空雷区 for (int i 0; i m_nRows; i) for (int j 0; j m_nCols; j) m_pMineMap[i][j] 0; // 随机布雷避开第一次点击的位置及其周围8格 int nPlaced 0; srand((unsigned)time(NULL)); while (nPlaced m_nMines) { int r rand() % m_nRows; int c rand() % m_nCols; // 避开首点位置周围3x3区域 if (abs(r - nFirstRow) 1 abs(c - nFirstCol) 1) continue; if (m_pMineMap[r][c] ! -1) { m_pMineMap[r][c] -1; // -1标记为雷 nPlaced; } } // 计算每个格子周围的雷数 for (int i 0; i m_nRows; i) { for (int j 0; j m_nCols; j) { if (m_pMineMap[i][j] -1) continue; int nCount 0; // 遍历周围8个方向 for (int dr -1; dr 1; dr) { for (int dc -1; dc 1; dc) { if (dr 0 dc 0) continue; int nr i dr, nc j dc; if (nr 0 nr m_nRows nc 0 nc m_nCols) if (m_pMineMap[nr][nc] -1) nCount; } } m_pMineMap[i][j] nCount; } } }这段代码有几个关键点。第一srand放在函数内部调用每次重开游戏都会重新播种保证随机性。第二避开首点周围3x3区域这是扫雷的通用规则否则第一下点开一片空白结果发现周围全是雷体验很差。第三计算周围雷数时用了双重循环遍历8个方向这是最直观的写法也可以用方向数组优化但没必要。注意rand()的随机性在Windows下够用但如果要做竞技级扫雷需要更好的随机源。另外如果雷数接近格子总数这个while循环可能长时间不退出实际项目中应该加一个最大尝试次数保护。3.2 递归展开点一下开一片扫雷最爽的瞬间就是点一下展开一大片。这个功能的实现依赖递归如果点开的格子周围没有雷数字为0就自动展开周围的8个格子对每个格子重复这个过程。// MineSweeperView.cpp void CMineSweeperView::RevealCell(int nRow, int nCol) { // 边界检查 if (nRow 0 || nRow m_pDoc-m_nRows || nCol 0 || nCol m_pDoc-m_nCols) return; // 已经翻开或插旗的格子不再处理 if (m_pDoc-m_pStateMap[nRow][nCol] ! 0) return; // 标记为已翻开 m_pDoc-m_pStateMap[nRow][nCol] 1; // 如果踩到雷游戏结束 if (m_pDoc-m_pMineMap[nRow][nCol] -1) { m_pDoc-m_bGameOver TRUE; // 触发重绘显示所有雷 Invalidate(); return; } // 如果周围没有雷递归展开周围8格 if (m_pDoc-m_pMineMap[nRow][nCol] 0) { for (int dr -1; dr 1; dr) { for (int dc -1; dc 1; dc) { if (dr 0 dc 0) continue; RevealCell(nRow dr, nCol dc); } } } }递归的终止条件有三个越界、已经翻开、踩到雷。每次递归调用都会先检查状态所以不会无限循环。但这里有个隐患如果棋盘很大递归深度可能超过栈限制。9x9的棋盘最大递归深度是8116x30是480都在安全范围内。但如果改成100x100就需要改成迭代加队列的方式。另外注意这个函数直接修改了文档类的数据然后调用Invalidate()触发重绘。视图和文档的职责在这里有点混但MFC项目里这种写法很常见因为简单直接。3.3 鼠标消息处理左键翻开右键插旗MFC的消息映射机制让鼠标处理很直观。在视图类的消息映射表里加上// MineSweeperView.h afx_msg void OnLButtonDown(UINT nFlags, CPoint point); afx_msg void OnRButtonDown(UINT nFlags, CPoint point); // MineSweeperView.cpp BEGIN_MESSAGE_MAP(CMineSweeperView, CView) ON_WM_LBUTTONDOWN() ON_WM_RBUTTONDOWN() END_MESSAGE_MAP()然后实现这两个函数void CMineSweeperView::OnLButtonDown(UINT nFlags, CPoint point) { if (m_pDoc-m_bGameOver) return; // 将像素坐标转换为格子坐标 int nCol point.x / CELL_SIZE; int nRow point.y / CELL_SIZE; // 边界检查 if (nRow 0 || nRow m_pDoc-m_nRows || nCol 0 || nCol m_pDoc-m_nCols) return; // 如果还没布雷先布雷 if (!m_pDoc-m_bMinesPlaced) { m_pDoc-PlaceMines(nRow, nCol); m_pDoc-m_bMinesPlaced TRUE; // 启动计时器 SetTimer(1, 1000, NULL); } // 插旗的格子不能左键翻开 if (m_pDoc-m_pStateMap[nRow][nCol] 2) return; RevealCell(nRow, nCol); CheckWin(); Invalidate(); } void CMineSweeperView::OnRButtonDown(UINT nFlags, CPoint point) { if (m_pDoc-m_bGameOver) return; int nCol point.x / CELL_SIZE; int nRow point.y / CELL_SIZE; if (nRow 0 || nRow m_pDoc-m_nRows || nCol 0 || nCol m_pDoc-m_nCols) return; // 只能对未翻开的格子插旗 if (m_pDoc-m_pStateMap[nRow][nCol] 0) { m_pDoc-m_pStateMap[nRow][nCol] 2; // 插旗 m_pDoc-m_nFlags; } else if (m_pDoc-m_pStateMap[nRow][nCol] 2) { m_pDoc-m_pStateMap[nRow][nCol] 0; // 取消插旗 m_pDoc-m_nFlags--; } Invalidate(); }CELL_SIZE是每个格子的像素大小通常设为20或25。坐标转换就是简单的除法因为格子是均匀排列的。注意左键处理里有个m_bMinesPlaced标志确保只在第一次点击时布雷。右键处理里插旗和取消插旗是切换逻辑同时更新m_nFlags计数。3.4 绘图用GDI画出扫雷界面MFC的绘图在OnDraw函数里完成。这个项目没有用双缓冲直接画对于小棋盘来说闪烁不明显。void CMineSweeperView::OnDraw(CDC* pDC) { CMineSweeperDoc* pDoc GetDocument(); ASSERT_VALID(pDoc); // 创建画笔和画刷 CPen penGray(PS_SOLID, 1, RGB(192, 192, 192)); CPen penDark(PS_SOLID, 1, RGB(128, 128, 128)); CBrush brushGray(RGB(192, 192, 192)); CBrush brushWhite(RGB(255, 255, 255)); for (int i 0; i pDoc-m_nRows; i) { for (int j 0; j pDoc-m_nCols; j) { int x j * CELL_SIZE; int y i * CELL_SIZE; CRect rect(x, y, x CELL_SIZE, y CELL_SIZE); if (pDoc-m_pStateMap[i][j] 0) { // 未翻开灰色凸起效果 pDC-FillRect(rect, brushGray); pDC-Draw3dRect(rect, RGB(255, 255, 255), RGB(128, 128, 128)); } else if (pDoc-m_pStateMap[i][j] 1) { // 已翻开白色背景 pDC-FillRect(rect, brushWhite); pDC-Draw3dRect(rect, RGB(128, 128, 128), RGB(255, 255, 255)); int nVal pDoc-m_pMineMap[i][j]; if (nVal 0) { // 根据数字设置颜色 COLORREF colors[] { RGB(0,0,0), RGB(0,0,255), RGB(0,128,0), RGB(255,0,0), RGB(0,0,128), RGB(128,0,0), RGB(0,128,128), RGB(0,0,0), RGB(128,128,128) }; pDC-SetTextColor(colors[nVal]); CString str; str.Format(_T(%d), nVal); pDC-DrawText(str, rect, DT_CENTER | DT_VCENTER | DT_SINGLELINE); } else if (nVal -1) { // 雷画一个黑色圆 pDC-Ellipse(rect.left 4, rect.top 4, rect.right - 4, rect.bottom - 4); } } else if (pDoc-m_pStateMap[i][j] 2) { // 插旗画一个红色三角 pDC-FillRect(rect, brushGray); pDC-Draw3dRect(rect, RGB(255, 255, 255), RGB(128, 128, 128)); POINT pts[3] { {x CELL_SIZE/2, y 4}, {x 4, y CELL_SIZE - 4}, {x CELL_SIZE - 4, y CELL_SIZE - 4} }; CBrush brushRed(RGB(255, 0, 0)); CBrush* pOld pDC-SelectObject(brushRed); pDC-Polygon(pts, 3); pDC-SelectObject(pOld); } } } }绘图逻辑分三种状态未翻开画灰色凸起已翻开画白色背景加数字或雷插旗画红色三角。数字颜色用了经典扫雷的配色方案1是蓝色2是绿色3是红色以此类推。Draw3dRect用来画立体边框这是Windows 95时代的经典风格。提示如果觉得闪烁严重可以在OnDraw里先用CreateCompatibleDC创建内存DC画完再BitBlt到屏幕。这是MFC双缓冲的标准做法代码量不大效果提升明显。4. 编译运行与常见问题排查4.1 编译环境准备这个项目用Visual Studio打开就能编译。推荐VS2019或VS2022社区版免费。打开.sln文件后确保安装了「使用C的桌面开发」工作负载里面包含MFC组件。如果编译时报错「无法打开包括文件 afxwin.h」说明MFC没装。在VS Installer里修改工作负载勾选「MFC和ATL支持」。编译配置选Debug或Release都行。Debug版带调试信息方便打断点Release版体积小、运行快。平台选x86或x64都可以代码没有平台相关的东西。4.2 常见编译错误错误1error C2065: CELL_SIZE: 未声明的标识符原因CELL_SIZE没有定义。解决在MineSweeperView.h或stdafx.h里加一行#define CELL_SIZE 20。错误2error LNK2019: 无法解析的外部符号原因某个函数声明了但没实现或者消息映射宏写错了。解决检查BEGIN_MESSAGE_MAP和END_MESSAGE_MAP之间是否包含了所有afx_msg函数的映射。错误3error C2664: 无法将参数从...转换原因字符集问题。MFC项目默认用Unicode但有些字符串字面量是ANSI。解决用_T()包裹字符串或者在项目属性里把字符集改成「使用多字节字符集」。4.3 运行时问题问题点击格子没反应排查步骤先在OnLButtonDown里加TRACE(_T(click: %d, %d\n), point.x, point.y);看输出窗口有没有打印。如果没有说明消息映射没生效检查BEGIN_MESSAGE_MAP里有没有ON_WM_LBUTTONDOWN()。如果有打印但格子没变化检查坐标转换是否正确CELL_SIZE是否和绘图时一致。问题递归展开时程序崩溃原因递归深度过大导致栈溢出或者数组越界。解决在RevealCell开头加边界检查确保nRow和nCol在有效范围内。如果棋盘很大改成用队列的迭代方式。问题计时器不工作原因SetTimer的调用时机不对。这个项目在第一次点击后才启动计时器所以如果没点击计时器不会走。解决确认SetTimer在PlaceMines之后被调用并且OnTimer函数里调用了Invalidate刷新显示。问题内存泄漏原因m_pMineMap和m_pStateMap是动态分配的二维数组如果析构函数里没释放就会泄漏。解决在CMineSweeperDoc的析构函数里加释放代码CMineSweeperDoc::~CMineSweeperDoc() { if (m_pMineMap) { for (int i 0; i m_nRows; i) delete[] m_pMineMap[i]; delete[] m_pMineMap; } if (m_pStateMap) { for (int i 0; i m_nRows; i) delete[] m_pStateMap[i]; delete[] m_pStateMap; } }5. 二次开发从能跑到好用我踩过的三个坑这份源码跑起来不难但想改成自己想要的样子有几个地方容易翻车。我按自己改的经历说三个点。5.1 改棋盘大小别只改一个地方想把9x9改成16x16很多人第一反应是改m_nRows和m_nCols的初始值。但改完发现界面错位、点击偏移。原因是CELL_SIZE是固定的棋盘变大后窗口没跟着变。正确的改法分三步。第一步在文档类的构造函数里改行列数和雷数CMineSweeperDoc::CMineSweeperDoc() { m_nRows 16; m_nCols 16; m_nMines 40; // ... 分配数组 }第二步在视图类的OnInitialUpdate里调整窗口大小void CMineSweeperView::OnInitialUpdate() { CView::OnInitialUpdate(); CMineSweeperDoc* pDoc GetDocument(); // 调整窗口客户区大小 GetParentFrame()-SetWindowPos(NULL, 0, 0, pDoc-m_nCols * CELL_SIZE 16, pDoc-m_nRows * CELL_SIZE 60, SWP_NOMOVE | SWP_NOZORDER); }第三步如果加了菜单栏或状态栏还要调整它们的高度。我一般会在MainFrm.cpp的OnCreate里根据棋盘大小动态计算。5.2 加双缓冲解决闪烁的后悔药原版绘图直接画在屏幕DC上快速点击时闪烁明显。加双缓冲是性价比最高的改造。在视图类里加一个成员变量CDC m_memDC和CBitmap m_memBitmap在OnDraw里先画到内存DC再一次性拷贝void CMineSweeperView::OnDraw(CDC* pDC) { CMineSweeperDoc* pDoc GetDocument(); CRect clientRect; GetClientRect(clientRect); // 创建内存DC如果尺寸变了就重建 if (!m_memDC.GetSafeHdc()) { m_memDC.CreateCompatibleDC(pDC); m_memBitmap.CreateCompatibleBitmap(pDC, clientRect.Width(), clientRect.Height()); m_memDC.SelectObject(m_memBitmap); } // 先画到内存DC DrawBoard(m_memDC); // 一次性拷贝到屏幕 pDC-BitBlt(0, 0, clientRect.Width(), clientRect.Height(), m_memDC, 0, 0, SRCCOPY); }把原来的绘图逻辑抽到DrawBoard函数里参数改成CDC*。这样改完闪烁基本消失。注意在窗口大小改变时重建内存位图否则会拉伸变形。5.3 加难度选择和排行榜原版只有一种难度想加初级、中级、高级三档需要在菜单里加选项然后根据选择重置游戏。核心是写一个ResetGame(int nLevel)函数void CMineSweeperDoc::ResetGame(int nLevel) { // 先释放旧数组 FreeArrays(); switch (nLevel) { case 0: m_nRows 9; m_nCols 9; m_nMines 10; break; case 1: m_nRows 16; m_nCols 16; m_nMines 40; break; case 2: m_nRows 16; m_nCols 30; m_nMines 99; break; } // 重新分配数组 AllocArrays(); m_bGameOver FALSE; m_bWin FALSE; m_bMinesPlaced FALSE; m_nFlags 0; m_nRemainMines m_nMines; }排行榜可以用一个简单的文本文件存格式就是「玩家名,用时,难度」。读取时按用时排序显示在前10名。不需要数据库CStdioFile就够用。5.4 验证改造是否成功改完之后怎么确认没改坏我一般走一遍这个清单检查项预期结果切换难度后棋盘大小窗口和格子都跟着变第一次点击不会踩雷且展开一片右键插旗旗子出现剩余雷数减1再次右键旗子消失剩余雷数加1踩雷所有雷显示游戏结束翻开所有非雷格子提示胜利计时停止快速连续点击界面不闪烁不崩溃关闭窗口无内存泄漏Debug模式看输出这个清单我每次改完都会跑一遍。有一次偷懒没跑结果改完棋盘大小后忘了改窗口尺寸点击坐标全错位被测试的人骂了一顿。从那以后我每次改完MFC的绘图或坐标相关代码都强制走一遍这个清单确认每个交互都正常。希望这份拆解能帮你把这份MFC扫雷源码跑起来也能按自己的想法改出个不一样的版本。本文还有配套的精品资源点击获取
简介这是一份面向Windows程序设计初学者与MFC进阶开发者的扫雷游戏完整源码工程基于Microsoft Foundation Classes框架实现帮助读者理解如何用C类库封装Win32 API、构建图形界面并处理消息循环。压缩包共71个文件约2.7MB包含7个cpp源文件与8个h头文件承载核心逻辑26个bmp位图与2个ico图标构成界面素材另有rc资源脚本、dsp/dsw工程文件及exe可执行程序可直接编译运行或对照调试。资源围绕雷区随机生成、CButton格子交互、计时统计、CDialog主界面布局与消息映射等模块展开源码中CMyDialog负责整体事件处理CMyButton定制单格行为便于读者梳理MFC消息机制与游戏逻辑的结合方式。目前已有475人学习下载适合作为课程设计、Windows编程练手或MFC框架入门的实践参考。1. 扫雷这游戏用MFC写一遍才知道坑在哪很多人第一次接触Windows桌面开发都是从扫雷这类小游戏开始的。看着简单一个网格、几个数字、左右键点一点但真动手用MFC写一遍你会发现消息映射、GDI绘图、定时器、递归展开这些机制一个都绕不开。这份源码就是一个完整的MFC扫雷实现包含工程文件和全部代码适合想学MFC但不知道拿什么练手的开发者也适合想拆解经典游戏逻辑的人。它不依赖任何第三方库纯Win32 API加MFC框架编译出来就是一个能跑的exe。下面我从工程结构、核心模块、编译运行到二次开发把这份源码拆开讲一遍。2. 工程结构与技术选型为什么是MFC而不是Qt2.1 目录里有什么拿到源码包第一件事是看目录结构。这个项目的组织方式很典型是Visual Studio的MFC应用程序向导生成的骨架然后在此基础上填充游戏逻辑。大致结构如下MineSweeper/ ├── MineSweeper.sln # VS解决方案文件 ├── MineSweeper/ │ ├── MineSweeper.h # 主头文件包含资源ID和全局定义 │ ├── MineSweeper.cpp # 应用程序入口InitInstance在这里 │ ├── MainFrm.h/.cpp # 主框架窗口类 │ ├── MineSweeperView.h/.cpp # 视图类游戏主逻辑所在 │ ├── MineSweeperDoc.h/.cpp # 文档类管理游戏数据 │ ├── resource.h # 资源ID定义 │ ├── res/ # 图标、菜单、位图等资源 │ └── stdafx.h/.cpp # 预编译头这是标准的MFC文档/视图架构。文档类负责存数据视图类负责画界面和响应输入。对于扫雷这种单窗口游戏来说文档/视图有点重但好处是数据与显示分离后面改起来清晰。2.2 为什么选MFC现在做Windows桌面开发Qt、Electron、WPF都是更主流的选择。但MFC有它的场景体积小、启动快、不依赖运行时库、直接调用Win32 API。这个扫雷项目编译出来大概几百KB双击就能跑不需要装任何东西。如果你维护的是老项目或者需要嵌入到已有的MFC系统里MFC就是最自然的选择。技术栈上这个项目用了MFC 4.2以上VS2010到VS2022都能编译GDI绘图用CDC类画网格、数字、雷区消息映射ON_WM_LBUTTONDOWN、ON_WM_RBUTTONDOWN处理鼠标定时器SetTimer做计时功能递归算法空白区域自动展开没有用GDI没有用DirectX全是基础API。这意味着代码可读性高但绘图效率一般。对于9x9到16x30的棋盘完全够用。2.3 核心数据结构游戏的数据模型不复杂但设计得好不好直接影响后面写逻辑的难度。这个项目用了两个二维数组来存状态// MineSweeperDoc.h 中的核心数据成员 class CMineSweeperDoc : public CDocument { protected: int m_nRows; // 行数 int m_nCols; // 列数 int m_nMines; // 雷的总数 int m_nFlags; // 已插旗数量 int m_nRemainMines; // 剩余雷数用于显示 BOOL m_bGameOver; // 游戏是否结束 BOOL m_bWin; // 是否胜利 // 核心数据每个格子的状态 // -1表示雷0-8表示周围雷数 int** m_pMineMap; // 每个格子的显示状态 // 0未翻开, 1已翻开, 2插旗, 3问号 int** m_pStateMap; // 记录哪些格子已经被翻开过用于递归展开 BOOL** m_pRevealed; };m_pMineMap存的是逻辑数据这个格子是不是雷周围有几颗雷。m_pStateMap存的是显示状态玩家看到的是未翻开、已翻开还是插了旗。两个数组分开的好处是重置游戏时只需要重新生成m_pMineMap显示状态统一清零就行。用int**而不是vectorvectorint是因为MFC项目通常不鼓励用STL而且二维指针在内存上是连续的访问效率高。但要注意在构造函数里分配析构函数里释放否则会内存泄漏。3. 核心模块拆解从布雷到递归展开的完整链路3.1 布雷算法第一下不能踩雷扫雷有个基本体验要求第一次点击不能踩雷。这个项目怎么做的不是在初始化时就布好雷而是等玩家第一次左键点击后再根据点击位置布雷。// MineSweeperDoc.cpp void CMineSweeperDoc::PlaceMines(int nFirstRow, int nFirstCol) { // 先清空雷区 for (int i 0; i m_nRows; i) for (int j 0; j m_nCols; j) m_pMineMap[i][j] 0; // 随机布雷避开第一次点击的位置及其周围8格 int nPlaced 0; srand((unsigned)time(NULL)); while (nPlaced m_nMines) { int r rand() % m_nRows; int c rand() % m_nCols; // 避开首点位置周围3x3区域 if (abs(r - nFirstRow) 1 abs(c - nFirstCol) 1) continue; if (m_pMineMap[r][c] ! -1) { m_pMineMap[r][c] -1; // -1标记为雷 nPlaced; } } // 计算每个格子周围的雷数 for (int i 0; i m_nRows; i) { for (int j 0; j m_nCols; j) { if (m_pMineMap[i][j] -1) continue; int nCount 0; // 遍历周围8个方向 for (int dr -1; dr 1; dr) { for (int dc -1; dc 1; dc) { if (dr 0 dc 0) continue; int nr i dr, nc j dc; if (nr 0 nr m_nRows nc 0 nc m_nCols) if (m_pMineMap[nr][nc] -1) nCount; } } m_pMineMap[i][j] nCount; } } }这段代码有几个关键点。第一srand放在函数内部调用每次重开游戏都会重新播种保证随机性。第二避开首点周围3x3区域这是扫雷的通用规则否则第一下点开一片空白结果发现周围全是雷体验很差。第三计算周围雷数时用了双重循环遍历8个方向这是最直观的写法也可以用方向数组优化但没必要。注意rand()的随机性在Windows下够用但如果要做竞技级扫雷需要更好的随机源。另外如果雷数接近格子总数这个while循环可能长时间不退出实际项目中应该加一个最大尝试次数保护。3.2 递归展开点一下开一片扫雷最爽的瞬间就是点一下展开一大片。这个功能的实现依赖递归如果点开的格子周围没有雷数字为0就自动展开周围的8个格子对每个格子重复这个过程。// MineSweeperView.cpp void CMineSweeperView::RevealCell(int nRow, int nCol) { // 边界检查 if (nRow 0 || nRow m_pDoc-m_nRows || nCol 0 || nCol m_pDoc-m_nCols) return; // 已经翻开或插旗的格子不再处理 if (m_pDoc-m_pStateMap[nRow][nCol] ! 0) return; // 标记为已翻开 m_pDoc-m_pStateMap[nRow][nCol] 1; // 如果踩到雷游戏结束 if (m_pDoc-m_pMineMap[nRow][nCol] -1) { m_pDoc-m_bGameOver TRUE; // 触发重绘显示所有雷 Invalidate(); return; } // 如果周围没有雷递归展开周围8格 if (m_pDoc-m_pMineMap[nRow][nCol] 0) { for (int dr -1; dr 1; dr) { for (int dc -1; dc 1; dc) { if (dr 0 dc 0) continue; RevealCell(nRow dr, nCol dc); } } } }递归的终止条件有三个越界、已经翻开、踩到雷。每次递归调用都会先检查状态所以不会无限循环。但这里有个隐患如果棋盘很大递归深度可能超过栈限制。9x9的棋盘最大递归深度是8116x30是480都在安全范围内。但如果改成100x100就需要改成迭代加队列的方式。另外注意这个函数直接修改了文档类的数据然后调用Invalidate()触发重绘。视图和文档的职责在这里有点混但MFC项目里这种写法很常见因为简单直接。3.3 鼠标消息处理左键翻开右键插旗MFC的消息映射机制让鼠标处理很直观。在视图类的消息映射表里加上// MineSweeperView.h afx_msg void OnLButtonDown(UINT nFlags, CPoint point); afx_msg void OnRButtonDown(UINT nFlags, CPoint point); // MineSweeperView.cpp BEGIN_MESSAGE_MAP(CMineSweeperView, CView) ON_WM_LBUTTONDOWN() ON_WM_RBUTTONDOWN() END_MESSAGE_MAP()然后实现这两个函数void CMineSweeperView::OnLButtonDown(UINT nFlags, CPoint point) { if (m_pDoc-m_bGameOver) return; // 将像素坐标转换为格子坐标 int nCol point.x / CELL_SIZE; int nRow point.y / CELL_SIZE; // 边界检查 if (nRow 0 || nRow m_pDoc-m_nRows || nCol 0 || nCol m_pDoc-m_nCols) return; // 如果还没布雷先布雷 if (!m_pDoc-m_bMinesPlaced) { m_pDoc-PlaceMines(nRow, nCol); m_pDoc-m_bMinesPlaced TRUE; // 启动计时器 SetTimer(1, 1000, NULL); } // 插旗的格子不能左键翻开 if (m_pDoc-m_pStateMap[nRow][nCol] 2) return; RevealCell(nRow, nCol); CheckWin(); Invalidate(); } void CMineSweeperView::OnRButtonDown(UINT nFlags, CPoint point) { if (m_pDoc-m_bGameOver) return; int nCol point.x / CELL_SIZE; int nRow point.y / CELL_SIZE; if (nRow 0 || nRow m_pDoc-m_nRows || nCol 0 || nCol m_pDoc-m_nCols) return; // 只能对未翻开的格子插旗 if (m_pDoc-m_pStateMap[nRow][nCol] 0) { m_pDoc-m_pStateMap[nRow][nCol] 2; // 插旗 m_pDoc-m_nFlags; } else if (m_pDoc-m_pStateMap[nRow][nCol] 2) { m_pDoc-m_pStateMap[nRow][nCol] 0; // 取消插旗 m_pDoc-m_nFlags--; } Invalidate(); }CELL_SIZE是每个格子的像素大小通常设为20或25。坐标转换就是简单的除法因为格子是均匀排列的。注意左键处理里有个m_bMinesPlaced标志确保只在第一次点击时布雷。右键处理里插旗和取消插旗是切换逻辑同时更新m_nFlags计数。3.4 绘图用GDI画出扫雷界面MFC的绘图在OnDraw函数里完成。这个项目没有用双缓冲直接画对于小棋盘来说闪烁不明显。void CMineSweeperView::OnDraw(CDC* pDC) { CMineSweeperDoc* pDoc GetDocument(); ASSERT_VALID(pDoc); // 创建画笔和画刷 CPen penGray(PS_SOLID, 1, RGB(192, 192, 192)); CPen penDark(PS_SOLID, 1, RGB(128, 128, 128)); CBrush brushGray(RGB(192, 192, 192)); CBrush brushWhite(RGB(255, 255, 255)); for (int i 0; i pDoc-m_nRows; i) { for (int j 0; j pDoc-m_nCols; j) { int x j * CELL_SIZE; int y i * CELL_SIZE; CRect rect(x, y, x CELL_SIZE, y CELL_SIZE); if (pDoc-m_pStateMap[i][j] 0) { // 未翻开灰色凸起效果 pDC-FillRect(rect, brushGray); pDC-Draw3dRect(rect, RGB(255, 255, 255), RGB(128, 128, 128)); } else if (pDoc-m_pStateMap[i][j] 1) { // 已翻开白色背景 pDC-FillRect(rect, brushWhite); pDC-Draw3dRect(rect, RGB(128, 128, 128), RGB(255, 255, 255)); int nVal pDoc-m_pMineMap[i][j]; if (nVal 0) { // 根据数字设置颜色 COLORREF colors[] { RGB(0,0,0), RGB(0,0,255), RGB(0,128,0), RGB(255,0,0), RGB(0,0,128), RGB(128,0,0), RGB(0,128,128), RGB(0,0,0), RGB(128,128,128) }; pDC-SetTextColor(colors[nVal]); CString str; str.Format(_T(%d), nVal); pDC-DrawText(str, rect, DT_CENTER | DT_VCENTER | DT_SINGLELINE); } else if (nVal -1) { // 雷画一个黑色圆 pDC-Ellipse(rect.left 4, rect.top 4, rect.right - 4, rect.bottom - 4); } } else if (pDoc-m_pStateMap[i][j] 2) { // 插旗画一个红色三角 pDC-FillRect(rect, brushGray); pDC-Draw3dRect(rect, RGB(255, 255, 255), RGB(128, 128, 128)); POINT pts[3] { {x CELL_SIZE/2, y 4}, {x 4, y CELL_SIZE - 4}, {x CELL_SIZE - 4, y CELL_SIZE - 4} }; CBrush brushRed(RGB(255, 0, 0)); CBrush* pOld pDC-SelectObject(brushRed); pDC-Polygon(pts, 3); pDC-SelectObject(pOld); } } } }绘图逻辑分三种状态未翻开画灰色凸起已翻开画白色背景加数字或雷插旗画红色三角。数字颜色用了经典扫雷的配色方案1是蓝色2是绿色3是红色以此类推。Draw3dRect用来画立体边框这是Windows 95时代的经典风格。提示如果觉得闪烁严重可以在OnDraw里先用CreateCompatibleDC创建内存DC画完再BitBlt到屏幕。这是MFC双缓冲的标准做法代码量不大效果提升明显。4. 编译运行与常见问题排查4.1 编译环境准备这个项目用Visual Studio打开就能编译。推荐VS2019或VS2022社区版免费。打开.sln文件后确保安装了「使用C的桌面开发」工作负载里面包含MFC组件。如果编译时报错「无法打开包括文件 afxwin.h」说明MFC没装。在VS Installer里修改工作负载勾选「MFC和ATL支持」。编译配置选Debug或Release都行。Debug版带调试信息方便打断点Release版体积小、运行快。平台选x86或x64都可以代码没有平台相关的东西。4.2 常见编译错误错误1error C2065: CELL_SIZE: 未声明的标识符原因CELL_SIZE没有定义。解决在MineSweeperView.h或stdafx.h里加一行#define CELL_SIZE 20。错误2error LNK2019: 无法解析的外部符号原因某个函数声明了但没实现或者消息映射宏写错了。解决检查BEGIN_MESSAGE_MAP和END_MESSAGE_MAP之间是否包含了所有afx_msg函数的映射。错误3error C2664: 无法将参数从...转换原因字符集问题。MFC项目默认用Unicode但有些字符串字面量是ANSI。解决用_T()包裹字符串或者在项目属性里把字符集改成「使用多字节字符集」。4.3 运行时问题问题点击格子没反应排查步骤先在OnLButtonDown里加TRACE(_T(click: %d, %d\n), point.x, point.y);看输出窗口有没有打印。如果没有说明消息映射没生效检查BEGIN_MESSAGE_MAP里有没有ON_WM_LBUTTONDOWN()。如果有打印但格子没变化检查坐标转换是否正确CELL_SIZE是否和绘图时一致。问题递归展开时程序崩溃原因递归深度过大导致栈溢出或者数组越界。解决在RevealCell开头加边界检查确保nRow和nCol在有效范围内。如果棋盘很大改成用队列的迭代方式。问题计时器不工作原因SetTimer的调用时机不对。这个项目在第一次点击后才启动计时器所以如果没点击计时器不会走。解决确认SetTimer在PlaceMines之后被调用并且OnTimer函数里调用了Invalidate刷新显示。问题内存泄漏原因m_pMineMap和m_pStateMap是动态分配的二维数组如果析构函数里没释放就会泄漏。解决在CMineSweeperDoc的析构函数里加释放代码CMineSweeperDoc::~CMineSweeperDoc() { if (m_pMineMap) { for (int i 0; i m_nRows; i) delete[] m_pMineMap[i]; delete[] m_pMineMap; } if (m_pStateMap) { for (int i 0; i m_nRows; i) delete[] m_pStateMap[i]; delete[] m_pStateMap; } }5. 二次开发从能跑到好用我踩过的三个坑这份源码跑起来不难但想改成自己想要的样子有几个地方容易翻车。我按自己改的经历说三个点。5.1 改棋盘大小别只改一个地方想把9x9改成16x16很多人第一反应是改m_nRows和m_nCols的初始值。但改完发现界面错位、点击偏移。原因是CELL_SIZE是固定的棋盘变大后窗口没跟着变。正确的改法分三步。第一步在文档类的构造函数里改行列数和雷数CMineSweeperDoc::CMineSweeperDoc() { m_nRows 16; m_nCols 16; m_nMines 40; // ... 分配数组 }第二步在视图类的OnInitialUpdate里调整窗口大小void CMineSweeperView::OnInitialUpdate() { CView::OnInitialUpdate(); CMineSweeperDoc* pDoc GetDocument(); // 调整窗口客户区大小 GetParentFrame()-SetWindowPos(NULL, 0, 0, pDoc-m_nCols * CELL_SIZE 16, pDoc-m_nRows * CELL_SIZE 60, SWP_NOMOVE | SWP_NOZORDER); }第三步如果加了菜单栏或状态栏还要调整它们的高度。我一般会在MainFrm.cpp的OnCreate里根据棋盘大小动态计算。5.2 加双缓冲解决闪烁的后悔药原版绘图直接画在屏幕DC上快速点击时闪烁明显。加双缓冲是性价比最高的改造。在视图类里加一个成员变量CDC m_memDC和CBitmap m_memBitmap在OnDraw里先画到内存DC再一次性拷贝void CMineSweeperView::OnDraw(CDC* pDC) { CMineSweeperDoc* pDoc GetDocument(); CRect clientRect; GetClientRect(clientRect); // 创建内存DC如果尺寸变了就重建 if (!m_memDC.GetSafeHdc()) { m_memDC.CreateCompatibleDC(pDC); m_memBitmap.CreateCompatibleBitmap(pDC, clientRect.Width(), clientRect.Height()); m_memDC.SelectObject(m_memBitmap); } // 先画到内存DC DrawBoard(m_memDC); // 一次性拷贝到屏幕 pDC-BitBlt(0, 0, clientRect.Width(), clientRect.Height(), m_memDC, 0, 0, SRCCOPY); }把原来的绘图逻辑抽到DrawBoard函数里参数改成CDC*。这样改完闪烁基本消失。注意在窗口大小改变时重建内存位图否则会拉伸变形。5.3 加难度选择和排行榜原版只有一种难度想加初级、中级、高级三档需要在菜单里加选项然后根据选择重置游戏。核心是写一个ResetGame(int nLevel)函数void CMineSweeperDoc::ResetGame(int nLevel) { // 先释放旧数组 FreeArrays(); switch (nLevel) { case 0: m_nRows 9; m_nCols 9; m_nMines 10; break; case 1: m_nRows 16; m_nCols 16; m_nMines 40; break; case 2: m_nRows 16; m_nCols 30; m_nMines 99; break; } // 重新分配数组 AllocArrays(); m_bGameOver FALSE; m_bWin FALSE; m_bMinesPlaced FALSE; m_nFlags 0; m_nRemainMines m_nMines; }排行榜可以用一个简单的文本文件存格式就是「玩家名,用时,难度」。读取时按用时排序显示在前10名。不需要数据库CStdioFile就够用。5.4 验证改造是否成功改完之后怎么确认没改坏我一般走一遍这个清单检查项预期结果切换难度后棋盘大小窗口和格子都跟着变第一次点击不会踩雷且展开一片右键插旗旗子出现剩余雷数减1再次右键旗子消失剩余雷数加1踩雷所有雷显示游戏结束翻开所有非雷格子提示胜利计时停止快速连续点击界面不闪烁不崩溃关闭窗口无内存泄漏Debug模式看输出这个清单我每次改完都会跑一遍。有一次偷懒没跑结果改完棋盘大小后忘了改窗口尺寸点击坐标全错位被测试的人骂了一顿。从那以后我每次改完MFC的绘图或坐标相关代码都强制走一遍这个清单确认每个交互都正常。希望这份拆解能帮你把这份MFC扫雷源码跑起来也能按自己的想法改出个不一样的版本。本文还有配套的精品资源点击获取
