C语言五子棋项目实战：从二维数组到游戏循环的编程思维训练

1. 项目概述从零到一用C语言构建你的第一个五子棋游戏最近在整理资料时翻到了几年前带新人时写的一个C语言五子棋小项目。当时为了让他们快速理解二维数组、循环控制和简单的AI逻辑特意把代码写得极其精简和清晰。没想到这个“古董级”的小程序在今天看来依然是理解C语言核心思想、锻炼编程逻辑的绝佳练手项目。它不依赖任何图形库纯粹在控制台里用字符画棋盘通过坐标输入下棋却完整地包含了游戏的核心循环、胜负判定和简单的人机交互。对于正在学习C语言、苦于没有合适小项目练手的同学或者想重温基础、感受编程最原始乐趣的朋友这个项目再合适不过了。这个简易五子棋的核心价值在于“麻雀虽小五脏俱全”。它迫使你去思考如何用最基础的数据结构二维数组来模拟一个游戏棋盘状态如何设计清晰易懂的游戏流程初始化、显示、落子、判断以及如何编写健壮的逻辑代码来处理各种边界情况比如输入坐标是否合法、是否已有棋子。完成它你不仅能巩固对C语言语法如数组、函数、条件判断的掌握更能建立起一个完整小项目的开发思维框架——从需求分析到模块划分再到编码实现和调试。下面我就把这个项目的完整思路、代码实现以及我踩过的那些“坑”毫无保留地分享出来。2. 核心思路与整体设计拆解在动手写代码之前我们先得把游戏怎么玩、程序怎么跑想清楚。五子棋的规则很简单双方在棋盘上交替落子先形成横向、纵向或斜向连续五个同色棋子的一方获胜。我们的程序需要模拟这个过程。2.1 数据结构设计棋盘的本质是一个二维数组首先如何表示棋盘和棋子这是最基础的一步。一个15x15的标准棋盘我们可以用一个15行15列的二维字符数组char board[15][15]来模拟。数组的每个元素代表棋盘上的一个交叉点。初始化时所有元素可以设为空格 或点号.表示空位。当玩家落子时就将对应位置的数组元素改为代表棋子的字符比如玩家用X电脑用O。为什么用字符数组而不用整数数组一方面是为了后续在控制台打印时更方便可以直接打印字符另一方面也节省内存虽然这点内存微不足道。这里有一个细节棋盘坐标的映射。用户习惯用行列的坐标比如“第3行第5列”。而C语言的二维数组也是先行后列。但需要注意的是用户输入的坐标通常从1开始计数第1行到第15行而数组索引是从0开始的。所以用户输入的坐标(row, col)需要转换为数组索引(row-1, col-1)。这个转换逻辑虽然简单但必须在整个程序中保持一致否则会导致严重的错位问题。2.2 程序流程设计一个经典的游戏循环整个程序的运行骨架是一个典型的“游戏循环”。我们可以将其分解为以下几个清晰的步骤初始化创建并初始化棋盘数组全部设为空位。设置当前玩家比如玩家先手。游戏主循环 a.清屏并显示当前棋盘将二维数组以网格形式打印到控制台让用户能看到当前局势。 b.提示当前玩家落子如果是玩家回合就提示输入行号和列号如果是电脑回合则自动计算落子位置简易AI部分。 c.检查落子合法性判断输入坐标是否在棋盘范围内并且该位置是否为空。如果不合法给出提示并重新输入。 d.执行落子在棋盘数组的对应位置放置当前玩家的棋子符号。 e.判断胜负落子后立即以该子为中心检查四个方向横、竖、左斜、右斜是否存在连续五个同色棋子。 f.切换玩家如果未分出胜负则交换当前玩家标识进入下一轮循环。游戏结束处理当胜负判定函数返回结果跳出主循环宣布获胜方或平局。这个流程看似线性但核心在于“循环”和“判定”。循环保证了游戏的持续进行判定决定了游戏的走向和终点。其中胜负判定逻辑是整个项目的算法核心也是最能体现编程思维的地方。2.3 模块化函数设计为了代码清晰、易于维护和调试我们必须把不同功能封装成独立的函数。这不仅是好习惯在后续调试时也能让你快速定位问题。主要函数包括void InitBoard(char board[][15], int size): 初始化棋盘。void DisplayBoard(char board[][15], int size): 打印棋盘这是门面要做得清晰美观。void PlayerMove(char board[][15], int size): 处理玩家落子包含输入验证。void ComputerMove(char board[][15], int size): 实现电脑的自动落子简易AI。int CheckWin(char board[][15], int size, int row, int col, char chess): 核心胜负判定函数在指定位置落子后判断是否获胜。通过这样的设计主函数main()将会非常简洁主要就是组织这些函数的调用顺序实现上述游戏循环。这种“高内聚、低耦合”的思想即使在这个小项目中也能得到很好的实践。3. 核心功能实现与代码精讲有了清晰的设计图我们就可以开始“砌砖”了。我会逐块讲解关键代码的实现并分享其中需要注意的细节和技巧。3.1 棋盘初始化与显示打造清晰的游戏界面初始化棋盘很简单一个双重循环搞定。void InitBoard(char board[][15], int size) { for (int i 0; i size; i) { for (int j 0; j size; j) { board[i][j] .; // 使用 . 表示空位比空格更直观 } } }显示棋盘则需要一些“美学”考虑。我们不仅要打印棋子还要打印网格线和坐标方便用户定位。void DisplayBoard(char board[][15], int size) { // 打印列号1-15 printf( ); for (int j 0; j size; j) { printf(%2d , j 1); } printf(\n); // 打印分隔线 printf( ); for (int j 0; j size; j) { printf(---); } printf(\n); // 打印每一行 for (int i 0; i size; i) { printf(%2d|, i 1); // 打印行号 for (int j 0; j size; j) { printf( %c , board[i][j]); // 打印棋子或空位 } printf(|\n); } // 打印底部边框 printf( ); for (int j 0; j size; j) { printf(---); } printf(\n); }实操心得在控制台做界面对齐是门学问。这里使用%2d和%c配合空格进行格式化输出能保证棋盘在大多数终端下显示整齐。如果你发现对不齐可能是字体比例问题可以尝试调整空格数量。另外用.而不是空格 表示空位是为了在棋盘初始状态也能看清网格范围调试的时候特别有用。3.2 玩家落子与输入验证鲁棒性的关键玩家落子函数需要处理用户输入这是程序与用户交互的窗口也是最容易出bug的地方。我们必须假设用户会输入各种奇怪的东西负数、超大的数、非数字、已经落子的位置等等。void PlayerMove(char board[][15], int size) { int row, col; while (1) { // 使用循环直到输入合法 printf(玩家[X]回合请输入落子位置 (行 列如 8 8): ); int result scanf(%d %d, row, col); // 检查输入格式是否正确是否成功读入两个整数 if (result ! 2) { printf(输入格式错误请重新输入。\n); // 清空输入缓冲区防止错误输入残留影响下一次读取 while (getchar() ! \n); continue; } // 检查坐标是否在有效范围内1到size if (row 1 || row size || col 1 || col size) { printf(坐标超出棋盘范围棋盘大小为1-%d。\n, size); continue; } // 转换为数组索引从0开始 int r row - 1; int c col - 1; // 检查该位置是否为空 if (board[r][c] ! .) { printf(该位置已有棋子请选择其他位置。\n); continue; } // 所有检查通过落子 board[r][c] X; break; // 跳出循环 } }踩坑记录scanf的返回值检查至关重要如果用户不小心输入了字母scanf(%d %d, ...)会匹配失败返回0或1取决于匹配成功几个并且错误的输入会留在缓冲区。如果不处理这个错误输入会导致下一次scanf继续失败程序陷入死循环。所以当输入格式错误时必须用while(getchar() ! \n);清空输入缓冲区。这是新手最容易忽略的导致程序崩溃的细节之一。3.3 胜负判定算法项目的灵魂所在这是整个项目最核心、最考验逻辑的部分。判断逻辑是在最新落子点(row, col)上向四个方向水平、垂直、左上到右下斜线、右上到左下斜线分别探测看每个方向上的连续同色棋子是否达到5个。int CheckWin(char board[][15], int size, int row, int col, char chess) { // 定义四个方向的增量数组{行增量, 列增量} int dir[4][2] { {0, 1}, // 水平向右 {1, 0}, // 垂直向下 {1, 1}, // 右下斜线 {1, -1} // 左下斜线 }; for (int d 0; d 4; d) { int count 1; // 计数包括当前落子本身 int dr dir[d][0]; int dc dir[d][1]; // 向正方向探测 for (int step 1; step 5; step) { int newRow row dr * step; int newCol col dc * step; // 检查是否越界以及棋子是否相同 if (newRow 0 || newRow size || newCol 0 || newCol size || board[newRow][newCol] ! chess) { break; } count; } // 向反方向探测 for (int step 1; step 5; step) { int newRow row - dr * step; // 注意这里是减号 int newCol col - dc * step; if (newRow 0 || newRow size || newCol 0 || newCol size || board[newRow][newCol] ! chess) { break; } count; } // 如果某个方向连续棋子数达到5则获胜 if (count 5) { return 1; // 获胜 } } return 0; // 未获胜 }算法精讲方向数组使用dir数组优雅地定义了四个方向避免了写四遍相似的代码。这是减少代码冗余、提高可读性的经典技巧。双向探测从落子点向一个方向的两边同时数。例如水平方向先向右数连续的X再向左数。这样写比单向数到底再回头更简洁逻辑也更清晰。边界控制在每次移动newRow和newCol前都必须检查是否还在棋盘[0, size-1]的范围内。这是防止数组越界访问的关键否则程序会访问非法内存导致崩溃或不可预知的行为。提前终止一旦发现某个方向上的棋子不连续了立即用break跳出该方向的计数循环提高效率。深度思考为什么是count 5而不是count 5理论上由于我们是从中间向两边数如果落子前已经存在四连子再落一子形成五连count正好是5。但考虑一种极端情况虽然规则上不允许如果棋盘上已经有超过5个连续的同色棋子count会大于5。使用是一种更安全的写法。不过在正确的游戏流程控制下落子后立即判断不会出现超过5连的情况也是可以的。体现了防御性编程的思想。3.4 简易电脑AI从随机到有点“脑子”如果只是人人对战那只需要一个玩家函数轮流调用。但加入电脑对手能让项目更有趣也更能体现逻辑。我们实现一个从简单到逐步进阶的AI。版本一完全随机落子这是最简单的AI在所有空位中随机选一个。虽然蠢但实现简单能保证游戏进行下去。#include stdlib.h #include time.h void ComputerMove_Random(char board[][15], int size) { int emptyPositions[225][2]; // 最大可能空位数 int count 0; // 收集所有空位 for (int i 0; i size; i) { for (int j 0; j size; j) { if (board[i][j] .) { emptyPositions[count][0] i; emptyPositions[count][1] j; count; } } } if (count 0) { srand(time(NULL)); // 设置随机种子 int index rand() % count; // 随机选择一个空位索引 int r emptyPositions[index][0]; int c emptyPositions[index][1]; board[r][c] O; printf(电脑在 (%d, %d) 落子。\n, r1, c1); } }版本二带优先级的随机防守型让电脑有点“意识”。策略是遍历所有空位模拟如果玩家在此落子是否会直接获胜形成四连且两端无阻挡。如果是则电脑必须在此落子防守。否则再随机落子。void ComputerMove_Smart(char board[][15], int size) { // 优先级1检查玩家是否有一步致胜的点有则堵住 for (int i 0; i size; i) { for (int j 0; j size; j) { if (board[i][j] .) { // 模拟玩家在此落子 board[i][j] X; if (CheckWin(board, size, i, j, X)) { // 如果玩家下这里会赢电脑必须下这里 board[i][j] O; // 改为电脑落子 printf(电脑防守在 (%d, %d) 落子。\n, i1, j1); return; } board[i][j] .; // 恢复空位 } } } // 优先级2检查电脑自己是否有一步致胜的点有则落子取胜 for (int i 0; i size; i) { for (int j 0; j size; j) { if (board[i][j] .) { board[i][j] O; if (CheckWin(board, size, i, j, O)) { printf(电脑进攻在 (%d, %d) 落子。\n, i1, j1); return; } board[i][j] .; } } } // 优先级3都没有则随机落子 ComputerMove_Random(board, size); }这个版本的AI已经具备了最基本的攻防意识虽然还是很弱但至少不会眼睁睁看着你连成五子。你可以在此基础上继续扩展比如增加对“活三”、“冲四”等棋形的判断AI就会越来越强。这其实就是博弈树搜索和评估函数的雏形。4. 主程序整合与游戏循环将上述所有模块像拼图一样组合起来就形成了完整的main函数。#include stdio.h #include stdlib.h #include time.h #define SIZE 15 // 此处插入之前定义的函数原型InitBoard, DisplayBoard, PlayerMove, ComputerMove_Smart, CheckWin int main() { char board[SIZE][SIZE]; int gameOver 0; int currentPlayer 1; // 1 表示玩家2 表示电脑 int steps 0; int maxSteps SIZE * SIZE; // 初始化随机种子 srand((unsigned int)time(NULL)); // 初始化棋盘 InitBoard(board, SIZE); printf( 简易控制台五子棋 \n); printf(玩家使用 X电脑使用 O。\n); // 游戏主循环 while (!gameOver steps maxSteps) { // 清屏Windows用system(cls)Linux/Mac用system(clear) // 为了兼容性这里注释掉实际可根据平台选择 // system(cls); // 显示棋盘 DisplayBoard(board, SIZE); if (currentPlayer 1) { // 玩家回合 PlayerMove(board, SIZE); // 获取玩家最后落子的位置需要在PlayerMove中记录或通过查找实现此处为简化假设能获取 // 实际中可以在PlayerMove内部调用CheckWin或修改PlayerMove返回落子位置。 // 这里我们采用一个简化方法在落子后立即全棋盘扫描最后一个X效率低但简单。 int lastRow -1, lastCol -1; for (int i 0; i SIZE; i) { for (int j 0; j SIZE; j) { if (board[i][j] X) { lastRow i; lastCol j; // 会找到最后一个不精确但可用 } } } if (CheckWin(board, SIZE, lastRow, lastCol, X)) { DisplayBoard(board, SIZE); printf(\n恭喜玩家获胜\n); gameOver 1; } } else { // 电脑回合 ComputerMove_Smart(board, SIZE); // 同样找到电脑最后落的O int lastRow -1, lastCol -1; for (int i 0; i SIZE; i) { for (int j 0; j SIZE; j) { if (board[i][j] O) { lastRow i; lastCol j; } } } if (CheckWin(board, SIZE, lastRow, lastCol, O)) { DisplayBoard(board, SIZE); printf(\n电脑获胜再接再厉\n); gameOver 1; } } // 切换玩家 currentPlayer (currentPlayer 1) ? 2 : 1; steps; } // 平局判断 if (!gameOver) { DisplayBoard(board, SIZE); printf(\n棋盘已满平局\n); } printf(游戏结束\n); return 0; }重要提示上面的主循环中为了简化演示我使用了一个低效的方法来获取最后落子位置全盘扫描。在实际的优化版本中你应该修改PlayerMove和ComputerMove函数让它们返回落子的行号和列号或者通过全局变量/指针参数传递出来。这样就能直接传递给CheckWin函数效率更高逻辑也更正确。这是一个很好的优化练习点。5. 编译、运行与调试实战代码写完了不等于项目完成了。从源代码到可运行的程序还有编译和调试这两步。5.1 编译与运行假设你将所有代码保存为一个文件gobang.c。打开终端或命令提示符进入文件所在目录。使用GCC编译Linux/Mac或Windows下的MinGWgcc -o gobang gobang.c这条命令告诉GCC编译器将gobang.c源文件编译成名为gobangWindows下是gobang.exe的可执行文件。-o参数指定输出文件名。运行程序Linux/Mac:./gobangWindows:gobang.exe如果编译报错仔细阅读错误信息。常见的错误包括语法错误少分号、括号不匹配、函数未声明检查函数原型是否放在main函数之前或头文件中、类型不匹配等。5.2 调试技巧与常见问题排查即使编译通过程序运行时也可能出现逻辑错误。以下是我在开发这个小项目时遇到和想到的典型问题及解决方法。问题1输入坐标后程序无反应或行为异常。可能原因输入缓冲区问题如3.2节所述。scanf读取后残留的换行符或错误字符影响了后续输入。排查方法在scanf后立即打印读入的row和col值看是否正确。使用while(getchar() ! \n);清空缓冲区。我的心得养成处理scanf返回值和清空缓冲区的习惯能避免一大半交互式程序的输入bug。问题2胜负判断有时不准四连子就判赢或者五连子不判赢。可能原因CheckWin函数中的边界条件或计数逻辑有误。排查方法这是最需要耐心的一步。构造几个简单的测试用例在棋盘中央水平放置5个连续的X在最后一个子落子后调用CheckWin看是否返回1。测试边界情况在棋盘最左边列索引为0垂直放5个子看是否能正确判断。测试四连子情况看是否错误判赢应返回0。调试技巧在CheckWin函数内部加入调试打印语句打印出每个方向探测时的count值观察计数过程是否符合预期。// 在CheckWin函数的循环内添加 printf(方向%d: 正方向计数%d, 反方向计数%d, 总数%d\n, d, count1, count2, count);问题3电脑AI太弱或太强随机时。可能原因随机数种子设置问题。如果在循环内频繁调用srand(time(NULL))而time(NULL)在短时间内返回值相同会导致随机数序列重复AI落子可能不“随机”。解决方法在整个程序中srand只应调用一次通常放在main函数开头。确保ComputerMove_Random函数内部不再调用srand。问题4棋盘显示错位。可能原因控制台字体不是等宽字体。大多数终端默认使用等宽字体如Consolas, Courier New如果被改为非等宽字体空格和字符宽度不同会导致表格线对不齐。解决方法将终端字体设置为等宽字体。或者调整DisplayBoard函数中的格式字符串尝试使用制表符\t或更精细的空格控制。5.3 功能扩展与优化建议当你成功运行基础版本后可以尝试以下扩展让这个小游戏更具挑战性和学习价值增加游戏模式在开始时让用户选择“人人对战”或“人机对战”。增强电脑AI实现一个简单的评分函数为每个空位打分分数基于如果在此落子会形成怎样的棋形如成五、活四、冲四、活三等。电脑选择分数最高的空位落子。引入搜索深度实现一个极小化极大算法Minimax或阿尔法-贝塔剪枝让电脑能向前看几步。这是向高级AI迈进的关键一步。美化界面使用Windows API或跨平台的图形库如EasyX Raylib绘制真正的图形界面。在控制台中使用Windows的system(color ...)或ANSI转义序列Linux/Mac及现代Windows终端支持来给棋子X和O上色。增加功能实现“悔棋”功能。这需要用一个栈或数组来记录每一步的落子位置。增加游戏存档和读档功能将棋盘状态保存到文件下次可以继续。6. 从项目实践到编程思维提升完成这个五子棋项目远不止是写了几百行代码。它是一次完整的、微型的软件开发演练。回顾整个过程我们可以提炼出对C语言学习乃至编程入门至关重要的几点经验第一数据结构的核心是建模。如何用程序中的变量一个二维字符数组来精准映射现实世界中的概念棋盘和棋子这是编程最基础也是最重要的能力。选对了数据结构后面的逻辑就会顺畅很多。第二复杂逻辑分解为简单函数。一个庞大的main函数是难以阅读、调试和维护的。将初始化、显示、落子、判断等功能拆分成独立的函数每个函数只做一件事并做好这就是“模块化”思想。它让代码结构清晰也让你能集中精力一次解决一个问题。第三边界条件和异常处理是代码健壮性的生命线。用户会输入负数吗坐标会超出数组范围吗落子位置是否已被占用这些在理想流程中不会发生的事在实际运行中必然会出现。优秀的程序必须能优雅地处理所有异常输入而不是崩溃。scanf的返回值检查和输入缓冲区的清理就是这个道理。第四调试是必备技能而非附加项。几乎没有一个程序能一次写对。学会使用printf打印关键变量“打印法调试”学会构造简单的测试用例学会耐心地跟踪程序执行流程这些调试技巧的价值不亚于编写新代码。面对一个不工作的函数不要慌张像侦探一样用打印的线索还原“案发现场”。这个简易五子棋项目就像一把钥匙帮你打开了用C语言解决实际问题的门。它涉及的数组、函数、循环、条件判断、输入输出正是C语言最核心的部分。吃透这个项目你不仅掌握了语法更初步拥有了“计算思维”——将复杂问题分解、抽象、再用代码一步步实现的能力。接下来你可以尝试用同样的思维去挑战其他小项目例如通讯录管理、简单计算器、文本小游戏等每一次实践都会让你的编程功底更加扎实。编程的世界很大但这个小小的棋盘无疑是一个坚实的起点。