很多同学在初学C语言时常常感觉语法枯燥学完指针、数组后不知道能做什么。其实通过一个完整的项目实战是巩固知识、提升编程思维的最佳途径。扫雷游戏就是一个经典的选择它几乎涵盖了C语言初级阶段的所有核心知识点二维数组、循环、条件判断、函数封装、递归甚至简单的算法思想。本文将带你从零开始用C语言实现一个控制台版本的扫雷游戏。我们会从游戏规则分析、数据结构设计开始一步步编写初始化、布置雷、排查雷、递归展开等核心函数并最终整合成一个可交互运行的程序。文末会提供完整的、可复制的源码并附上详细的讲解和常见问题排查确保你不仅能运行起来更能理解每一行代码背后的逻辑。无论你是正在学习C语言的大一学生还是想重温基础的程序员这篇教程都能让你有所收获。让我们开始吧1. 扫雷游戏规则与核心逻辑分析在动手编码之前我们必须先明确我们要实现什么以及如何用程序逻辑来模拟它。1.1 经典扫雷游戏规则回顾扫雷游戏通常在一个矩形网格中进行网格中的每个格子可能是以下三种状态之一未翻开格子被覆盖玩家看不到内容。已翻开格子被点击后会显示其内容。已标记玩家怀疑该格子是雷可以插上旗子Flag或问号Question Mark进行标记。格子内容分为以下几种地雷Mine如果玩家翻开了地雷则游戏失败。数字表示该格子周围8个相邻格子中存在的地雷数量。空白表示该格子周围8个相邻格子中没有地雷。在经典规则中翻开一个空白格子会触发连锁反应自动翻开所有相邻的空白格子及其周围的数字格子直到被数字包围。游戏目标在不触雷的前提下翻开所有非雷的格子。玩家可以通过数字提示来推理哪些格子是安全的哪些是地雷。1.2 程序实现的核心逻辑拆解要将上述规则转化为C语言程序我们需要解决以下几个核心问题数据存储如何用C语言的数据结构主要是二维数组来表示雷盘的状态和内容初始化如何随机生成一个指定雷数的雷盘玩家交互如何接收玩家的坐标输入和操作指令翻开/标记核心算法计算周围雷数如何为一个非雷格子计算其周围8格的地雷总数递归展开当玩家翻开一个周围雷数为0的格子空白格时如何实现自动展开一片区域的效果游戏状态判断如何判断游戏是胜利所有非雷格被翻开还是失败踩到雷理解了这些核心问题我们的编码工作就有了清晰的路线图。2. 环境准备与项目结构2.1 开发环境说明本项目对开发环境要求极低任何支持标准C语言C99或以上的编译环境均可。操作系统Windows, Linux, macOS 均可。编译器GCC (MinGW), Clang, MSVC 等。本文示例使用 GCC。开发工具任何文本编辑器如 VS Code, Sublime Text, Notepad或集成开发环境如 Code::Blocks, Dev-C, CLion都可以。运行环境程序将在控制台终端/命令行中运行使用字符界面进行交互。2.2 创建项目与文件结构建议创建一个单独的文件夹来管理项目文件结构清晰利于维护。Minesweeper_C/ ├── game.h // 头文件包含函数声明、常量定义、结构体定义 ├── game.c // 源文件包含游戏核心逻辑的函数实现 ├── main.c // 源文件包含主函数负责游戏流程控制 └── README.md // 项目说明文件可选我们将采用模块化编程将不同的功能分离到不同的文件中这样做的好处是代码清晰功能模块划分明确。易于维护修改一个模块不会轻易影响其他部分。便于协作多人开发时可以分工明确。接下来我们开始定义游戏的核心数据结构和常量。3. 数据结构设计与核心函数规划3.1 定义常量和数据结构在game.h头文件中我们首先定义游戏所需的常量和用于表示雷盘的数据结构。// game.h #ifndef __GAME_H__ // 防止头文件被重复包含 #define __GAME_H__ #include stdio.h #include stdlib.h #include time.h // 定义雷盘大小和地雷数量 // 注意为了简化边界处理我们实际创建的数组会比显示区域大一圈 #define ROW 9 // 显示给玩家的行数 #define COL 9 // 显示给玩家的列数 #define ROWS (ROW2) // 实际数组的行数 (ROW 上下边界) #define COLS (COL2) // 实际数组的列数 (COL 左右边界) #define EASY_COUNT 10 // 简单难度地雷数量 // 定义格子状态用于显示给玩家看的数组 #define EMPTY // 未翻开状态显示为空格或覆盖字符 #define MINE * // 地雷游戏失败时显示 #define FLAG F // 玩家标记的旗子 #define QUESTION ? // 玩家标记的问号 // 定义两个核心的二维数组 // mine数组用于存储地雷的分布1表示雷0表示非雷 // show数组用于显示给玩家看的信息包含EMPTY, 数字字符, FLAG等 // 我们将在game.c中声明它们为外部变量或通过函数参数传递。 // 函数声明 void InitBoard(char board[ROWS][COLS], int rows, int cols, char set); void DisplayBoard(char board[ROWS][COLS], int row, int col); void SetMine(char mine[ROWS][COLS], int row, int col, int count); int GetMineCount(char mine[ROWS][COLS], int x, int y); void ExpandBoard(char mine[ROWS][COLS], char show[ROWS][COLS], int x, int y); void FindMine(char mine[ROWS][COLS], char show[ROWS][COLS], int row, int col, int mineCount); #endif // __GAME_H__关键点解释ROWS和COLS比ROW和COL大2这是本设计的一个精髓。它创建了一个“缓冲区”使得我们在计算任意一个有效格子(x,y)1xROW, 1yCOL周围的雷数时可以统一访问其周围的8个坐标(x-1,y-1)到(x1,y1)而无需担心数组越界。这极大地简化了边界条件的判断代码。我们使用两个数组mine数组存储地雷的真实分布这是一个“后台”数组玩家不可见。雷用字符1表示非雷用字符0表示。使用字符是为了方便计算ASCII码的1和0相差1。show数组存储展示给玩家看的信息。初始为EMPTY翻开后可能是数字字符如1,2或MINE玩家也可以标记为FLAG或QUESTION。3.2 核心函数功能规划根据游戏逻辑我们规划了以下几个核心函数InitBoard: 初始化棋盘用指定的字符set填充整个数组。DisplayBoard: 打印棋盘只打印中间ROW x COL的有效区域并加上行号和列号以便玩家查看。SetMine: 在mine数组的有效区域中随机布置指定数量count的地雷。GetMineCount: 计算指定坐标(x,y)周围8个格子中的地雷总数。ExpandBoard:递归展开函数。当玩家翻开的格子周围雷数为0时自动展开相邻的非雷区域。FindMine: 处理玩家排雷的核心逻辑包括接收输入、判断操作、更新show数组、判断游戏状态。有了清晰的设计蓝图我们就可以开始逐个实现这些函数了。4. 核心功能模块实现我们将在game.c文件中实现所有声明的函数。4.1 初始化与打印棋盘// game.c #include game.h // 初始化棋盘 // board: 要初始化的数组 // rows, cols: 数组的实际尺寸 (ROWS, COLS) // set: 初始化时填充的字符 void InitBoard(char board[ROWS][COLS], int rows, int cols, char set) { for (int i 0; i rows; i) { for (int j 0; j cols; j) { board[i][j] set; } } } // 打印棋盘 // board: 要打印的数组 // row, col: 需要打印的有效区域大小 (ROW, COL) void DisplayBoard(char board[ROWS][COLS], int row, int col) { printf(-------- 扫雷 --------\n); // 打印列号 printf( ); for (int j 1; j col; j) { printf(%d , j); } printf(\n); printf( ); for (int j 1; j col; j) { printf(--); } printf(\n); // 打印每一行前面加上行号 for (int i 1; i row; i) { printf(%d | , i); for (int j 1; j col; j) { printf(%c , board[i][j]); } printf(\n); } printf(\n); }代码讲解InitBoard使用双重循环将数组的每一个元素都设置为指定的字符set。对于mine数组我们初始化为0对于show数组我们初始化为EMPTY空格。DisplayBoard是玩家与游戏交互的窗口。它只打印从索引1到row/col的有效区域。开头的列号和每行前的行号是为了让玩家能方便地输入坐标例如“3 5”表示第3行第5列。打印的格式可以根据个人喜好调整。4.2 随机布置地雷// game.c (续) // 布置地雷 // mine: 地雷分布数组 // row, col: 有效区域大小 // count: 要布置的地雷数量 void SetMine(char mine[ROWS][COLS], int row, int col, int count) { while (count) { // 生成1到row/col之间的随机坐标 int x rand() % row 1; int y rand() % col 1; // 检查该位置是否已经是雷 if (mine[x][y] 0) { mine[x][y] 1; // 放置地雷 count--; // 成功布置一颗计数器减一 } // 如果已经是雷则重新生成坐标 } }代码讲解使用rand()函数生成随机坐标。非常重要的是在main函数中必须调用srand((unsigned int)time(NULL));来设置随机数种子否则每次运行游戏地雷位置都一样。rand() % row生成0到row-1的随机数1后映射到1到row的有效范围。通过if (mine[x][y] 0)判断该位置是否已有雷避免重复布置。while (count)循环确保布置完指定数量的地雷。4.3 计算周围雷数与递归展开这是游戏逻辑中最关键的两个算法。// game.c (续) // 获取指定坐标周围的地雷数量 int GetMineCount(char mine[ROWS][COLS], int x, int y) { // 利用字符0和1的ASCII码特性进行计算 // 周围8个格子的值相加然后减去8个0的ASCII码得到雷的数量 return (mine[x-1][y-1] mine[x-1][y] mine[x-1][y1] mine[x][y-1] mine[x][y1] mine[x1][y-1] mine[x1][y] mine[x1][y1] - 8 * 0); } // 递归展开函数 (核心算法) // 当玩家点击的坐标(x,y)周围雷数为0时调用此函数 void ExpandBoard(char mine[ROWS][COLS], char show[ROWS][COLS], int x, int y) { // 递归终止条件 // 1. 坐标越界虽然我们有缓冲区但递归可能传到无效区需检查 // 2. 该位置在show数组中已经不是未翻开状态(EMPTY)防止重复处理 if (x 1 || x ROW || y 1 || y COL) { return; } if (show[x][y] ! EMPTY) { return; } // 计算当前坐标周围的雷数 int count GetMineCount(mine, x, y); if (count 0) { // 如果周围有雷则显示雷数并停止递归 show[x][y] count 0; // 将数字转换为对应的字符如 1 - 1 return; } // 如果周围雷数为0将该位置标记为已翻开这里可以用空格或0表示空白 show[x][y] ; // 用空格表示一片空白区域视觉上更清晰 // 递归地向周围8个方向展开 ExpandBoard(mine, show, x - 1, y - 1); ExpandBoard(mine, show, x - 1, y); ExpandBoard(mine, show, x - 1, y 1); ExpandBoard(mine, show, x, y - 1); ExpandBoard(mine, show, x, y 1); ExpandBoard(mine, show, x 1, y - 1); ExpandBoard(mine, show, x 1, y); ExpandBoard(mine, show, x 1, y 1); }代码讲解GetMineCount: 这是本项目的一个巧妙技巧。因为mine数组中雷用1表示非雷用0表示它们都是字符。字符0的ASCII码是481是49。将周围8个字符的ASCII码相加再减去8 * 0(即8*48)得到的结果正好是雷的数量因为每个非雷0贡献0每个雷1贡献1。这比用if语句逐个判断简洁高效得多。ExpandBoard: 这是实现“一点开一片”效果的核心。终止条件坐标越界或该格子已处理过则直接返回。计算雷数调用GetMineCount。如果雷数0将数字转换成字符count 0存入show数组并返回。这是递归的“叶子节点”。如果雷数0将show数组对应位置设为空格 然后递归地对其周围8个格子调用ExpandBoard函数。这是递归的“扩散过程”。注意递归可能会比较深但对于9x9的棋盘最大深度有限不会导致栈溢出。这是一种经典的“深度优先搜索”(DFS)思想的应用。4.4 玩家排雷与游戏流程控制// game.c (续) // 排雷并判断游戏状态 // 返回值1表示游戏继续0表示游戏结束赢或输 int FindMine(char mine[ROWS][COLS], char show[ROWS][COLS], int row, int col, int mineCount) { int x 0; int y 0; int win 0; // 记录已翻开的非雷格子数量 while (win row * col - mineCount) { printf(请输入要操作的坐标 (行 列)或输入 0 0 进行标记/取消标记: ); scanf(%d %d, x, y); // 检查坐标合法性 if (x 1 x row y 1 y col) { // 翻开操作 if (show[x][y] EMPTY) { // 只能翻开未翻开的格子 if (mine[x][y] 1) { // 踩到雷了 printf(\n很遗憾你踩到雷了游戏结束。\n); DisplayBoard(mine, ROW, COL); // 展示雷的位置 return 0; // 游戏结束失败 } else { // 没有踩到雷 ExpandBoard(mine, show, x, y); // 递归展开 system(cls); // Windows清屏命令Linux/Mac可用 system(clear); DisplayBoard(show, ROW, COL); // 显示更新后的棋盘 // 重新计算已翻开的非雷格子数遍历show数组 win 0; for (int i 1; i row; i) { for (int j 1; j col; j) { if (show[i][j] ! EMPTY show[i][j] ! FLAG show[i][j] ! QUESTION) { win; } } } } } else { printf(该位置已被翻开或标记请重新选择。\n); } } else if (x 0 y 0) { // 标记模式 printf(进入标记模式请输入要标记的坐标 (行 列): ); scanf(%d %d, x, y); if (x 1 x row y 1 y col) { if (show[x][y] EMPTY) { show[x][y] FLAG; printf(已在(%d,%d)插上旗子。\n, x, y); } else if (show[x][y] FLAG) { show[x][y] QUESTION; printf(已将(%d,%d)的旗子改为问号。\n, x, y); } else if (show[x][y] QUESTION) { show[x][y] EMPTY; printf(已取消(%d,%d)的标记。\n, x, y); } else { printf(无法标记已翻开的格子。\n); } system(cls); DisplayBoard(show, ROW, COL); } else { printf(坐标无效\n); } } else { printf(坐标非法请输入1-%d之间的行和列。\n, row); } } // 循环结束说明所有非雷格都已翻开 printf(\n恭喜你排雷成功\n); DisplayBoard(mine, ROW, COL); // 展示最终的雷盘 return 0; // 游戏结束胜利 }代码讲解游戏继续条件while (win row * col - mineCount)。row*col是总格子数减去mineCount雷数得到非雷格子总数。只有当翻开的非雷格子数win小于这个总数时游戏才继续。玩家输入接收两个整数作为坐标。坐标判断合法坐标1~row/col执行翻开或标记逻辑。输入0 0进入标记模式允许玩家在旗子(F)、问号(?)、未标记( )之间循环切换。非法坐标提示错误。翻开逻辑检查目标格子是否未翻开(EMPTY)。如果是雷(mine[x][y] 1)游戏失败显示全部地雷。如果不是雷调用ExpandBoard函数进行递归展开。展开后清屏并重新打印棋盘然后重新计算已翻开的非雷格子数(win)。这里使用遍历show数组的方式统计所有不是EMPTY、FLAG、QUESTION的格子。注意标记的格子不计入已翻开。标记逻辑实现了一个简单的状态循环EMPTY-FLAG-QUESTION-EMPTY。胜利判断当while循环正常退出时意味着所有非雷格都已翻开玩家获胜。5. 主函数整合与游戏流程最后我们在main.c文件中编写主函数将各个模块串联起来形成完整的游戏流程。// main.c #include game.h void menu() { printf(**************************\n); printf(****** 1. play ******\n); printf(****** 0. exit ******\n); printf(**************************\n); } void game() { // 创建并初始化两个棋盘 char mine[ROWS][COLS] {0}; // 存放地雷信息 char show[ROWS][COLS] {0}; // 存放展示给玩家的信息 InitBoard(mine, ROWS, COLS, 0); // 初始化mine数组为全0 InitBoard(show, ROWS, COLS, EMPTY); // 初始化show数组为全空格 // 布置地雷 SetMine(mine, ROW, COL, EASY_COUNT); // 打印一下测试用正式游戏时可注释掉 // DisplayBoard(mine, ROW, COL); // 打印初始游戏界面 DisplayBoard(show, ROW, COL); // 开始排雷 FindMine(mine, show, ROW, COL, EASY_COUNT); } int main() { int input 0; // 设置随机数种子 srand((unsigned int)time(NULL)); do { menu(); printf(请选择: ); scanf(%d, input); switch (input) { case 1: game(); break; case 0: printf(退出游戏\n); break; default: printf(选择错误请重新选择\n); break; } } while (input); return 0; }代码讲解menu()函数打印简单的菜单。game()函数是单局游戏的完整流程定义并初始化mine和show两个二维数组。调用SetMine在mine数组中随机布置地雷。调用DisplayBoard打印初始的show棋盘全是未翻开状态。调用FindMine函数进入游戏主循环处理玩家输入和游戏逻辑直到游戏结束。main()函数调用srand((unsigned int)time(NULL));这是关键一步确保每次运行游戏地雷位置不同。提供一个循环菜单玩家可以选择开始新游戏或退出。6. 编译运行与效果演示6.1 如何编译运行假设你的项目文件结构如前所述在命令行中例如在MinGW或Linux终端下进入项目目录使用gcc编译gcc main.c game.c -o minesweeper然后运行生成的可执行文件# Windows minesweeper.exe # Linux/Mac ./minesweeper6.2 游戏运行效果示例程序运行后你会看到类似下面的界面************************** ****** 1. play ****** ****** 0. exit ****** ************************** 请选择: 1 -------- 扫雷 -------- 1 2 3 4 5 6 7 8 9 ----------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 请输入要操作的坐标 (行 列)或输入 0 0 进行标记/取消标记: 5 5 -------- 扫雷 -------- 1 2 3 4 5 6 7 8 9 ----------------- 1 | 2 | 3 | 4 | 1 5 | 6 | 7 | 8 | 9 |输入坐标后程序会根据算法展开一片区域并显示数字请输入要操作的坐标 (行 列)或输入 0 0 进行标记/取消标记: 0 0 进入标记模式请输入要标记的坐标 (行 列): 1 1 已在(1,1)插上旗子。 -------- 扫雷 -------- 1 2 3 4 5 6 7 8 9 ----------------- 1 | F 2 | 3 | 4 | 1 5 | 6 | 7 | 8 | 9 |游戏会一直进行直到你踩到雷失败或翻开所有非雷格子胜利。7. 项目扩展与优化建议完成基础版本后你可以尝试以下挑战来深化对C语言和游戏逻辑的理解增加难度等级修改ROW,COL,EASY_COUNT的定义或者通过菜单让玩家选择初级(9x9, 10雷)、中级(16x16, 40雷)、高级(16x30, 99雷)。这涉及到动态内存分配使用malloc或定义多组常量。优化递归展开效率当前的递归展开在空白区域很大时可能会有重复判断。可以学习并使用“广度优先搜索(BFS)”配合队列数据结构来实现效率更高且不会栈溢出对于大棋盘。首次点击保护确保玩家第一次点击绝对不会是雷。可以在SetMine之后如果第一次点击的坐标是雷则将该雷移动到另一个随机空白位置。添加计时器与计步器使用time.h库中的clock()函数记录游戏用时并统计玩家点击次数。图形界面使用第三方库如EasyX(Windows) 或SDL、raylib(跨平台) 为游戏添加图形界面用图片代替字符体验更佳。保存与读取游戏将当前的mine和show数组状态写入文件下次可以继续游戏。这涉及到C语言文件读写操作 (fopen,fwrite,fread)。8. 常见问题与调试技巧在实现过程中你可能会遇到以下问题问题现象可能原因解决方案编译错误undefined reference to ...没有将game.c文件一起编译使用gcc main.c game.c -o ...命令确保所有源文件都被编译。地雷位置每次运行都一样没有设置随机数种子或设置位置不对在main函数开头且只在开头调用一次srand((unsigned int)time(NULL));。递归展开时程序崩溃栈溢出递归没有终止条件或条件有误仔细检查ExpandBoard函数的前两个if返回条件确保坐标有效且未处理过。计算周围雷数结果不对GetMineCount函数计算错误或mine数组初始化不对确保mine数组用0初始化雷用1布置。检查GetMineCount中的坐标加减是否正确。游戏胜利判断不准win变量计算逻辑有误在FindMine中每次翻开后要重新遍历show数组计算已翻开的非雷格。标记(F,?)的格子不应计入。标记功能混乱标记状态切换逻辑错误检查FindMine中标记模式的if-else if链确保状态按EMPTY-FLAG-QUESTION-EMPTY循环。清屏命令不工作system(“cls”)是Windows命令在Linux/Mac下使用system(“clear”)。可以写一个条件编译来适配不同系统。调试技巧打印中间状态在关键函数如SetMine后、ExpandBoard递归前后临时打印mine或show数组观察数据是否符合预期。使用调试器如果使用IDE如Code::Blocks, CLion, VS学会使用断点(breakpoint)和逐行调试(step into/over)观察变量值的变化。测试边界情况专门测试坐标(1,1), (ROW, COL)等边界位置的展开和计算是否正确。通过这个项目你不仅实现了一个经典游戏更系统地练习了C语言的数组、函数、递归、随机数、条件判断、循环等核心知识。理解整个项目的设计思路和代码细节远比单纯复制代码运行一遍更有价值。 
长河君 · 2026/8/9 6:05:06 · 阅读 1.2k C语言项目实战：控制台扫雷游戏开发与核心算法解析
很多同学在初学C语言时常常感觉语法枯燥学完指针、数组后不知道能做什么。其实通过一个完整的项目实战是巩固知识、提升编程思维的最佳途径。扫雷游戏就是一个经典的选择它几乎涵盖了C语言初级阶段的所有核心知识点二维数组、循环、条件判断、函数封装、递归甚至简单的算法思想。本文将带你从零开始用C语言实现一个控制台版本的扫雷游戏。我们会从游戏规则分析、数据结构设计开始一步步编写初始化、布置雷、排查雷、递归展开等核心函数并最终整合成一个可交互运行的程序。文末会提供完整的、可复制的源码并附上详细的讲解和常见问题排查确保你不仅能运行起来更能理解每一行代码背后的逻辑。无论你是正在学习C语言的大一学生还是想重温基础的程序员这篇教程都能让你有所收获。让我们开始吧1. 扫雷游戏规则与核心逻辑分析在动手编码之前我们必须先明确我们要实现什么以及如何用程序逻辑来模拟它。1.1 经典扫雷游戏规则回顾扫雷游戏通常在一个矩形网格中进行网格中的每个格子可能是以下三种状态之一未翻开格子被覆盖玩家看不到内容。已翻开格子被点击后会显示其内容。已标记玩家怀疑该格子是雷可以插上旗子Flag或问号Question Mark进行标记。格子内容分为以下几种地雷Mine如果玩家翻开了地雷则游戏失败。数字表示该格子周围8个相邻格子中存在的地雷数量。空白表示该格子周围8个相邻格子中没有地雷。在经典规则中翻开一个空白格子会触发连锁反应自动翻开所有相邻的空白格子及其周围的数字格子直到被数字包围。游戏目标在不触雷的前提下翻开所有非雷的格子。玩家可以通过数字提示来推理哪些格子是安全的哪些是地雷。1.2 程序实现的核心逻辑拆解要将上述规则转化为C语言程序我们需要解决以下几个核心问题数据存储如何用C语言的数据结构主要是二维数组来表示雷盘的状态和内容初始化如何随机生成一个指定雷数的雷盘玩家交互如何接收玩家的坐标输入和操作指令翻开/标记核心算法计算周围雷数如何为一个非雷格子计算其周围8格的地雷总数递归展开当玩家翻开一个周围雷数为0的格子空白格时如何实现自动展开一片区域的效果游戏状态判断如何判断游戏是胜利所有非雷格被翻开还是失败踩到雷理解了这些核心问题我们的编码工作就有了清晰的路线图。2. 环境准备与项目结构2.1 开发环境说明本项目对开发环境要求极低任何支持标准C语言C99或以上的编译环境均可。操作系统Windows, Linux, macOS 均可。编译器GCC (MinGW), Clang, MSVC 等。本文示例使用 GCC。开发工具任何文本编辑器如 VS Code, Sublime Text, Notepad或集成开发环境如 Code::Blocks, Dev-C, CLion都可以。运行环境程序将在控制台终端/命令行中运行使用字符界面进行交互。2.2 创建项目与文件结构建议创建一个单独的文件夹来管理项目文件结构清晰利于维护。Minesweeper_C/ ├── game.h // 头文件包含函数声明、常量定义、结构体定义 ├── game.c // 源文件包含游戏核心逻辑的函数实现 ├── main.c // 源文件包含主函数负责游戏流程控制 └── README.md // 项目说明文件可选我们将采用模块化编程将不同的功能分离到不同的文件中这样做的好处是代码清晰功能模块划分明确。易于维护修改一个模块不会轻易影响其他部分。便于协作多人开发时可以分工明确。接下来我们开始定义游戏的核心数据结构和常量。3. 数据结构设计与核心函数规划3.1 定义常量和数据结构在game.h头文件中我们首先定义游戏所需的常量和用于表示雷盘的数据结构。// game.h #ifndef __GAME_H__ // 防止头文件被重复包含 #define __GAME_H__ #include stdio.h #include stdlib.h #include time.h // 定义雷盘大小和地雷数量 // 注意为了简化边界处理我们实际创建的数组会比显示区域大一圈 #define ROW 9 // 显示给玩家的行数 #define COL 9 // 显示给玩家的列数 #define ROWS (ROW2) // 实际数组的行数 (ROW 上下边界) #define COLS (COL2) // 实际数组的列数 (COL 左右边界) #define EASY_COUNT 10 // 简单难度地雷数量 // 定义格子状态用于显示给玩家看的数组 #define EMPTY // 未翻开状态显示为空格或覆盖字符 #define MINE * // 地雷游戏失败时显示 #define FLAG F // 玩家标记的旗子 #define QUESTION ? // 玩家标记的问号 // 定义两个核心的二维数组 // mine数组用于存储地雷的分布1表示雷0表示非雷 // show数组用于显示给玩家看的信息包含EMPTY, 数字字符, FLAG等 // 我们将在game.c中声明它们为外部变量或通过函数参数传递。 // 函数声明 void InitBoard(char board[ROWS][COLS], int rows, int cols, char set); void DisplayBoard(char board[ROWS][COLS], int row, int col); void SetMine(char mine[ROWS][COLS], int row, int col, int count); int GetMineCount(char mine[ROWS][COLS], int x, int y); void ExpandBoard(char mine[ROWS][COLS], char show[ROWS][COLS], int x, int y); void FindMine(char mine[ROWS][COLS], char show[ROWS][COLS], int row, int col, int mineCount); #endif // __GAME_H__关键点解释ROWS和COLS比ROW和COL大2这是本设计的一个精髓。它创建了一个“缓冲区”使得我们在计算任意一个有效格子(x,y)1xROW, 1yCOL周围的雷数时可以统一访问其周围的8个坐标(x-1,y-1)到(x1,y1)而无需担心数组越界。这极大地简化了边界条件的判断代码。我们使用两个数组mine数组存储地雷的真实分布这是一个“后台”数组玩家不可见。雷用字符1表示非雷用字符0表示。使用字符是为了方便计算ASCII码的1和0相差1。show数组存储展示给玩家看的信息。初始为EMPTY翻开后可能是数字字符如1,2或MINE玩家也可以标记为FLAG或QUESTION。3.2 核心函数功能规划根据游戏逻辑我们规划了以下几个核心函数InitBoard: 初始化棋盘用指定的字符set填充整个数组。DisplayBoard: 打印棋盘只打印中间ROW x COL的有效区域并加上行号和列号以便玩家查看。SetMine: 在mine数组的有效区域中随机布置指定数量count的地雷。GetMineCount: 计算指定坐标(x,y)周围8个格子中的地雷总数。ExpandBoard:递归展开函数。当玩家翻开的格子周围雷数为0时自动展开相邻的非雷区域。FindMine: 处理玩家排雷的核心逻辑包括接收输入、判断操作、更新show数组、判断游戏状态。有了清晰的设计蓝图我们就可以开始逐个实现这些函数了。4. 核心功能模块实现我们将在game.c文件中实现所有声明的函数。4.1 初始化与打印棋盘// game.c #include game.h // 初始化棋盘 // board: 要初始化的数组 // rows, cols: 数组的实际尺寸 (ROWS, COLS) // set: 初始化时填充的字符 void InitBoard(char board[ROWS][COLS], int rows, int cols, char set) { for (int i 0; i rows; i) { for (int j 0; j cols; j) { board[i][j] set; } } } // 打印棋盘 // board: 要打印的数组 // row, col: 需要打印的有效区域大小 (ROW, COL) void DisplayBoard(char board[ROWS][COLS], int row, int col) { printf(-------- 扫雷 --------\n); // 打印列号 printf( ); for (int j 1; j col; j) { printf(%d , j); } printf(\n); printf( ); for (int j 1; j col; j) { printf(--); } printf(\n); // 打印每一行前面加上行号 for (int i 1; i row; i) { printf(%d | , i); for (int j 1; j col; j) { printf(%c , board[i][j]); } printf(\n); } printf(\n); }代码讲解InitBoard使用双重循环将数组的每一个元素都设置为指定的字符set。对于mine数组我们初始化为0对于show数组我们初始化为EMPTY空格。DisplayBoard是玩家与游戏交互的窗口。它只打印从索引1到row/col的有效区域。开头的列号和每行前的行号是为了让玩家能方便地输入坐标例如“3 5”表示第3行第5列。打印的格式可以根据个人喜好调整。4.2 随机布置地雷// game.c (续) // 布置地雷 // mine: 地雷分布数组 // row, col: 有效区域大小 // count: 要布置的地雷数量 void SetMine(char mine[ROWS][COLS], int row, int col, int count) { while (count) { // 生成1到row/col之间的随机坐标 int x rand() % row 1; int y rand() % col 1; // 检查该位置是否已经是雷 if (mine[x][y] 0) { mine[x][y] 1; // 放置地雷 count--; // 成功布置一颗计数器减一 } // 如果已经是雷则重新生成坐标 } }代码讲解使用rand()函数生成随机坐标。非常重要的是在main函数中必须调用srand((unsigned int)time(NULL));来设置随机数种子否则每次运行游戏地雷位置都一样。rand() % row生成0到row-1的随机数1后映射到1到row的有效范围。通过if (mine[x][y] 0)判断该位置是否已有雷避免重复布置。while (count)循环确保布置完指定数量的地雷。4.3 计算周围雷数与递归展开这是游戏逻辑中最关键的两个算法。// game.c (续) // 获取指定坐标周围的地雷数量 int GetMineCount(char mine[ROWS][COLS], int x, int y) { // 利用字符0和1的ASCII码特性进行计算 // 周围8个格子的值相加然后减去8个0的ASCII码得到雷的数量 return (mine[x-1][y-1] mine[x-1][y] mine[x-1][y1] mine[x][y-1] mine[x][y1] mine[x1][y-1] mine[x1][y] mine[x1][y1] - 8 * 0); } // 递归展开函数 (核心算法) // 当玩家点击的坐标(x,y)周围雷数为0时调用此函数 void ExpandBoard(char mine[ROWS][COLS], char show[ROWS][COLS], int x, int y) { // 递归终止条件 // 1. 坐标越界虽然我们有缓冲区但递归可能传到无效区需检查 // 2. 该位置在show数组中已经不是未翻开状态(EMPTY)防止重复处理 if (x 1 || x ROW || y 1 || y COL) { return; } if (show[x][y] ! EMPTY) { return; } // 计算当前坐标周围的雷数 int count GetMineCount(mine, x, y); if (count 0) { // 如果周围有雷则显示雷数并停止递归 show[x][y] count 0; // 将数字转换为对应的字符如 1 - 1 return; } // 如果周围雷数为0将该位置标记为已翻开这里可以用空格或0表示空白 show[x][y] ; // 用空格表示一片空白区域视觉上更清晰 // 递归地向周围8个方向展开 ExpandBoard(mine, show, x - 1, y - 1); ExpandBoard(mine, show, x - 1, y); ExpandBoard(mine, show, x - 1, y 1); ExpandBoard(mine, show, x, y - 1); ExpandBoard(mine, show, x, y 1); ExpandBoard(mine, show, x 1, y - 1); ExpandBoard(mine, show, x 1, y); ExpandBoard(mine, show, x 1, y 1); }代码讲解GetMineCount: 这是本项目的一个巧妙技巧。因为mine数组中雷用1表示非雷用0表示它们都是字符。字符0的ASCII码是481是49。将周围8个字符的ASCII码相加再减去8 * 0(即8*48)得到的结果正好是雷的数量因为每个非雷0贡献0每个雷1贡献1。这比用if语句逐个判断简洁高效得多。ExpandBoard: 这是实现“一点开一片”效果的核心。终止条件坐标越界或该格子已处理过则直接返回。计算雷数调用GetMineCount。如果雷数0将数字转换成字符count 0存入show数组并返回。这是递归的“叶子节点”。如果雷数0将show数组对应位置设为空格 然后递归地对其周围8个格子调用ExpandBoard函数。这是递归的“扩散过程”。注意递归可能会比较深但对于9x9的棋盘最大深度有限不会导致栈溢出。这是一种经典的“深度优先搜索”(DFS)思想的应用。4.4 玩家排雷与游戏流程控制// game.c (续) // 排雷并判断游戏状态 // 返回值1表示游戏继续0表示游戏结束赢或输 int FindMine(char mine[ROWS][COLS], char show[ROWS][COLS], int row, int col, int mineCount) { int x 0; int y 0; int win 0; // 记录已翻开的非雷格子数量 while (win row * col - mineCount) { printf(请输入要操作的坐标 (行 列)或输入 0 0 进行标记/取消标记: ); scanf(%d %d, x, y); // 检查坐标合法性 if (x 1 x row y 1 y col) { // 翻开操作 if (show[x][y] EMPTY) { // 只能翻开未翻开的格子 if (mine[x][y] 1) { // 踩到雷了 printf(\n很遗憾你踩到雷了游戏结束。\n); DisplayBoard(mine, ROW, COL); // 展示雷的位置 return 0; // 游戏结束失败 } else { // 没有踩到雷 ExpandBoard(mine, show, x, y); // 递归展开 system(cls); // Windows清屏命令Linux/Mac可用 system(clear); DisplayBoard(show, ROW, COL); // 显示更新后的棋盘 // 重新计算已翻开的非雷格子数遍历show数组 win 0; for (int i 1; i row; i) { for (int j 1; j col; j) { if (show[i][j] ! EMPTY show[i][j] ! FLAG show[i][j] ! QUESTION) { win; } } } } } else { printf(该位置已被翻开或标记请重新选择。\n); } } else if (x 0 y 0) { // 标记模式 printf(进入标记模式请输入要标记的坐标 (行 列): ); scanf(%d %d, x, y); if (x 1 x row y 1 y col) { if (show[x][y] EMPTY) { show[x][y] FLAG; printf(已在(%d,%d)插上旗子。\n, x, y); } else if (show[x][y] FLAG) { show[x][y] QUESTION; printf(已将(%d,%d)的旗子改为问号。\n, x, y); } else if (show[x][y] QUESTION) { show[x][y] EMPTY; printf(已取消(%d,%d)的标记。\n, x, y); } else { printf(无法标记已翻开的格子。\n); } system(cls); DisplayBoard(show, ROW, COL); } else { printf(坐标无效\n); } } else { printf(坐标非法请输入1-%d之间的行和列。\n, row); } } // 循环结束说明所有非雷格都已翻开 printf(\n恭喜你排雷成功\n); DisplayBoard(mine, ROW, COL); // 展示最终的雷盘 return 0; // 游戏结束胜利 }代码讲解游戏继续条件while (win row * col - mineCount)。row*col是总格子数减去mineCount雷数得到非雷格子总数。只有当翻开的非雷格子数win小于这个总数时游戏才继续。玩家输入接收两个整数作为坐标。坐标判断合法坐标1~row/col执行翻开或标记逻辑。输入0 0进入标记模式允许玩家在旗子(F)、问号(?)、未标记( )之间循环切换。非法坐标提示错误。翻开逻辑检查目标格子是否未翻开(EMPTY)。如果是雷(mine[x][y] 1)游戏失败显示全部地雷。如果不是雷调用ExpandBoard函数进行递归展开。展开后清屏并重新打印棋盘然后重新计算已翻开的非雷格子数(win)。这里使用遍历show数组的方式统计所有不是EMPTY、FLAG、QUESTION的格子。注意标记的格子不计入已翻开。标记逻辑实现了一个简单的状态循环EMPTY-FLAG-QUESTION-EMPTY。胜利判断当while循环正常退出时意味着所有非雷格都已翻开玩家获胜。5. 主函数整合与游戏流程最后我们在main.c文件中编写主函数将各个模块串联起来形成完整的游戏流程。// main.c #include game.h void menu() { printf(**************************\n); printf(****** 1. play ******\n); printf(****** 0. exit ******\n); printf(**************************\n); } void game() { // 创建并初始化两个棋盘 char mine[ROWS][COLS] {0}; // 存放地雷信息 char show[ROWS][COLS] {0}; // 存放展示给玩家的信息 InitBoard(mine, ROWS, COLS, 0); // 初始化mine数组为全0 InitBoard(show, ROWS, COLS, EMPTY); // 初始化show数组为全空格 // 布置地雷 SetMine(mine, ROW, COL, EASY_COUNT); // 打印一下测试用正式游戏时可注释掉 // DisplayBoard(mine, ROW, COL); // 打印初始游戏界面 DisplayBoard(show, ROW, COL); // 开始排雷 FindMine(mine, show, ROW, COL, EASY_COUNT); } int main() { int input 0; // 设置随机数种子 srand((unsigned int)time(NULL)); do { menu(); printf(请选择: ); scanf(%d, input); switch (input) { case 1: game(); break; case 0: printf(退出游戏\n); break; default: printf(选择错误请重新选择\n); break; } } while (input); return 0; }代码讲解menu()函数打印简单的菜单。game()函数是单局游戏的完整流程定义并初始化mine和show两个二维数组。调用SetMine在mine数组中随机布置地雷。调用DisplayBoard打印初始的show棋盘全是未翻开状态。调用FindMine函数进入游戏主循环处理玩家输入和游戏逻辑直到游戏结束。main()函数调用srand((unsigned int)time(NULL));这是关键一步确保每次运行游戏地雷位置不同。提供一个循环菜单玩家可以选择开始新游戏或退出。6. 编译运行与效果演示6.1 如何编译运行假设你的项目文件结构如前所述在命令行中例如在MinGW或Linux终端下进入项目目录使用gcc编译gcc main.c game.c -o minesweeper然后运行生成的可执行文件# Windows minesweeper.exe # Linux/Mac ./minesweeper6.2 游戏运行效果示例程序运行后你会看到类似下面的界面************************** ****** 1. play ****** ****** 0. exit ****** ************************** 请选择: 1 -------- 扫雷 -------- 1 2 3 4 5 6 7 8 9 ----------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 请输入要操作的坐标 (行 列)或输入 0 0 进行标记/取消标记: 5 5 -------- 扫雷 -------- 1 2 3 4 5 6 7 8 9 ----------------- 1 | 2 | 3 | 4 | 1 5 | 6 | 7 | 8 | 9 |输入坐标后程序会根据算法展开一片区域并显示数字请输入要操作的坐标 (行 列)或输入 0 0 进行标记/取消标记: 0 0 进入标记模式请输入要标记的坐标 (行 列): 1 1 已在(1,1)插上旗子。 -------- 扫雷 -------- 1 2 3 4 5 6 7 8 9 ----------------- 1 | F 2 | 3 | 4 | 1 5 | 6 | 7 | 8 | 9 |游戏会一直进行直到你踩到雷失败或翻开所有非雷格子胜利。7. 项目扩展与优化建议完成基础版本后你可以尝试以下挑战来深化对C语言和游戏逻辑的理解增加难度等级修改ROW,COL,EASY_COUNT的定义或者通过菜单让玩家选择初级(9x9, 10雷)、中级(16x16, 40雷)、高级(16x30, 99雷)。这涉及到动态内存分配使用malloc或定义多组常量。优化递归展开效率当前的递归展开在空白区域很大时可能会有重复判断。可以学习并使用“广度优先搜索(BFS)”配合队列数据结构来实现效率更高且不会栈溢出对于大棋盘。首次点击保护确保玩家第一次点击绝对不会是雷。可以在SetMine之后如果第一次点击的坐标是雷则将该雷移动到另一个随机空白位置。添加计时器与计步器使用time.h库中的clock()函数记录游戏用时并统计玩家点击次数。图形界面使用第三方库如EasyX(Windows) 或SDL、raylib(跨平台) 为游戏添加图形界面用图片代替字符体验更佳。保存与读取游戏将当前的mine和show数组状态写入文件下次可以继续游戏。这涉及到C语言文件读写操作 (fopen,fwrite,fread)。8. 常见问题与调试技巧在实现过程中你可能会遇到以下问题问题现象可能原因解决方案编译错误undefined reference to ...没有将game.c文件一起编译使用gcc main.c game.c -o ...命令确保所有源文件都被编译。地雷位置每次运行都一样没有设置随机数种子或设置位置不对在main函数开头且只在开头调用一次srand((unsigned int)time(NULL));。递归展开时程序崩溃栈溢出递归没有终止条件或条件有误仔细检查ExpandBoard函数的前两个if返回条件确保坐标有效且未处理过。计算周围雷数结果不对GetMineCount函数计算错误或mine数组初始化不对确保mine数组用0初始化雷用1布置。检查GetMineCount中的坐标加减是否正确。游戏胜利判断不准win变量计算逻辑有误在FindMine中每次翻开后要重新遍历show数组计算已翻开的非雷格。标记(F,?)的格子不应计入。标记功能混乱标记状态切换逻辑错误检查FindMine中标记模式的if-else if链确保状态按EMPTY-FLAG-QUESTION-EMPTY循环。清屏命令不工作system(“cls”)是Windows命令在Linux/Mac下使用system(“clear”)。可以写一个条件编译来适配不同系统。调试技巧打印中间状态在关键函数如SetMine后、ExpandBoard递归前后临时打印mine或show数组观察数据是否符合预期。使用调试器如果使用IDE如Code::Blocks, CLion, VS学会使用断点(breakpoint)和逐行调试(step into/over)观察变量值的变化。测试边界情况专门测试坐标(1,1), (ROW, COL)等边界位置的展开和计算是否正确。通过这个项目你不仅实现了一个经典游戏更系统地练习了C语言的数组、函数、递归、随机数、条件判断、循环等核心知识。理解整个项目的设计思路和代码细节远比单纯复制代码运行一遍更有价值。