VS2019下用C语言手写扫雷游戏：从代码解析到实战调试（附完整源码）

VS2019下用C语言手写扫雷游戏：从代码解析到实战调试（附完整源码）

扫雷游戏作为Windows经典游戏之一，其简洁的规则和适度的挑战性使其成为编程初学者练习逻辑思维和数组操作的绝佳案例。本文将带你在Visual Studio 2019环境下，从零开始构建一个完整的扫雷游戏，不仅涵盖基础代码实现，更会深入探讨VS特有的调试技巧和常见问题解决方案。

1. 环境准备与项目配置

在开始编码前，正确的开发环境配置至关重要。VS2019作为微软主推的IDE，对C语言的支持虽不如C++全面，但通过适当配置仍能获得良好的开发体验。

首先新建一个空项目：

1. 启动VS2019，选择"创建新项目"
2. 搜索并选择"空项目"模板
3. 为项目命名（如"MineSweeper"）并指定位置

关键配置项：

• 在解决方案资源管理器中右键项目 → 属性
• 配置属性 → C/C++ → 所有选项 → SDL检查设为"否"
• C/C++ → 预处理器 → 预处理器定义添加_CRT_SECURE_NO_WARNINGS

提示：禁用SDL检查可以避免VS对某些"不安全"函数的警告，但实际项目中应谨慎使用此设置。

2. 游戏核心数据结构设计

扫雷游戏的核心在于两个二维数组的协同工作：一个用于存储地雷的实际分布（mine数组），另一个用于显示玩家当前看到的棋盘状态（show数组）。

#define EASY_COUNT 10 // 初级难度地雷数 #define ROW 9 // 实际显示行数 #define COL 9 // 实际显示列数 #define ROWS ROW+2 // 包含边界的总行数 #define COLS COL+2 // 包含边界的总列数 char mine[ROWS][COLS] = {0}; // 地雷分布图 char show[ROWS][COLS] = {0}; // 玩家视图

这种设计有三大优势：

1. 边界处理简化：通过使用比显示区域大一圈的数组，可以避免在检查边缘格子时的数组越界问题
2. 内存效率高：静态数组在栈上分配，访问速度快
3. 调试可视化：可以直接在调试器中观察整个数组内容

3. 关键功能模块实现

3.1 棋盘初始化与显示

初始化函数需要处理两种不同的棋盘状态：

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; } } }

显示函数则需要考虑用户友好性：

void DisplayBoard(char board[ROWS][COLS], int row, int col) { printf(" "); for(int i = 1; i <= col; i++) { printf("%2d ", i); // 列号显示 } printf("\n"); for(int i = 1; i <= row; i++) { printf("%2d ", i); // 行号显示 for(int j = 1; j <= col; j++) { printf(" %c ", board[i][j]); } printf("\n"); } }

3.2 随机布雷算法

使用标准库的随机数函数时，有几个关键点需要注意：

void SetMine(char board[ROWS][COLS], int row, int col) { int count = EASY_COUNT; while(count > 0) { int x = rand() % row + 1; // 1~row int y = rand() % col + 1; // 1~col if(board[x][y] == '0') { board[x][y] = '1'; count--; } } }

常见问题及解决方案：

• 随机性不足：忘记调用srand((unsigned)time(NULL));导致每次运行雷的位置相同
• 重复布雷：需要检查目标位置是否已有雷
• 边界错误：确保随机数范围正确（1~row/col）

3.3 扫雷逻辑实现

计算周围地雷数量的函数展示了数组操作的典型用法：

int GetMineCount(char mine[ROWS][COLS], int x, int y) { return (mine[x-1][y-1] + mine[x-1][y] + mine[x-1][y+1] + mine[x][y-1] + mine[x][y+1] + mine[x+1][y-1] + mine[x+1][y] + mine[x+1][y+1] - 8*'0'); }

排查地雷的主逻辑需要处理多种用户输入情况：

void FindMine(char mine[ROWS][COLS], char show[ROWS][COLS], int row, int col) { int x = 0, y = 0; int win = 0; while(win < row*col - EASY_COUNT) { printf("请输入坐标(x y):"); int ret = scanf("%d %d", &x, &y); // 处理输入错误 if(ret != 2 || x<1 || x>row || y<1 || y>col) { while(getchar() != '\n'); // 清空输入缓冲区 printf("输入无效，请重新输入\n"); continue; } // 检查是否踩雷 if(mine[x][y] == '1') { printf("很遗憾，你踩到雷了！\n"); DisplayBoard(mine, ROW, COL); return; } // 计算周围雷数并更新显示 int count = GetMineCount(mine, x, y); show[x][y] = count + '0'; DisplayBoard(show, ROW, COL); win++; } printf("恭喜你，扫雷成功！\n"); }

4. VS2019特有问题的解决方案

4.1 scanf_s的安全警告

VS2019默认会强制使用更安全的scanf_s函数，这可能导致直接从网络复制的代码无法编译。有两种解决方案：

1. 使用宏定义兼容：

#pragma warning(disable:4996) #define _CRT_SECURE_NO_WARNINGS

2. 修改为scanf_s语法：

// 原代码 scanf("%d", &input); // 修改后 scanf_s("%d", &input, (unsigned)_countof(&input));

4.2 调试内存错误

扫雷游戏常见的内存错误包括：

• 数组越界访问
• 未初始化内存的使用
• 缓冲区溢出

VS2019提供了强大的调试工具：

• 内存窗口：查看数组实际内容
• 数据断点：当地雷数组被修改时中断
• 运行时检查：启用"基本运行时检查"可以捕获许多常见错误

调试技巧示例：

1. 在SetMine函数设置断点
2. 观察mine数组的内存内容
3. 使用"局部变量"窗口监控count值的变化

4.3 多文件项目组织

随着项目复杂度增加，建议将代码拆分到多个文件中：

MineSweeper/ ├── MineSweeper.sln ├── MineSweeper/ ├── game.h // 函数声明 ├── game.c // 游戏逻辑实现 ├── main.c // 主程序入口 └── MineSweeper.vcxproj

头文件示例（game.h）：

#pragma once #define EASY_COUNT 10 #define ROW 9 #define COL 9 #define ROWS ROW+2 #define COLS COL+2 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 board[ROWS][COLS], int row, int col); void FindMine(char mine[ROWS][COLS], char show[ROWS][COLS], int row, int col);

5. 游戏难度调整与功能扩展

通过修改预定义常量可以轻松调整游戏难度：

进阶功能扩展思路：

1. 计时系统：使用<time.h>记录游戏时间
2. 排行榜：将成绩保存到文件
3. 标记功能：允许玩家标记可能的地雷位置
4. 自动展开：当周围无雷时自动展开空白区域

实现标记功能的代码示例：

// 在FindMine函数中添加 if(show[x][y] == '?') { show[x][y] = '*'; } else if(show[x][y] == '*') { show[x][y] = '?'; } DisplayBoard(show, ROW, COL); continue;

6. 完整源码与项目文件

最终的完整项目包含以下关键文件：

main.c

#include "game.h" void menu() { printf("**************************\n"); printf("****** 1. 开始游戏 ******\n"); printf("****** 0. 退出游戏 ******\n"); printf("**************************\n"); } void game() { char mine[ROWS][COLS] = {0}; char show[ROWS][COLS] = {0}; InitBoard(mine, ROWS, COLS, '0'); InitBoard(show, ROWS, COLS, '*'); SetMine(mine, ROW, COL); DisplayBoard(show, ROW, COL); FindMine(mine, show, ROW, COL); } int main() { int input = 0; srand((unsigned)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; }

game.c

#include "game.h" 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; } } } void DisplayBoard(char board[ROWS][COLS], int row, int col) { // ... 同前文实现 ... } void SetMine(char board[ROWS][COLS], int row, int col) { // ... 同前文实现 ... } int GetMineCount(char mine[ROWS][COLS], int x, int y) { // ... 同前文实现 ... } void FindMine(char mine[ROWS][COLS], char show[ROWS][COLS], int row, int col) { // ... 同前文实现 ... }

在实际教学中发现，初学者最容易在数组索引和输入处理上犯错。例如，在调试一个学生的代码时，发现他的游戏总是异常结束，最终排查发现是GetMineCount函数中误用了x+1而不是x-1导致数组越界。VS2019的内存诊断工具在这种情况下特别有用，可以通过观察调用堆栈和变量值快速定位问题。