简介基于C语言与EasyX图形库的五子棋游戏项目适合正在学习C语言图形编程、游戏逻辑与简单AI设计的开发者。资源以Visual Studio工程形式组织包含6个cpp源文件main、menu、pTm、iti、pTp、other等模块及对应头文件提供可运行的exe、项目配置sln/vcxproj与生成日志另有65张图片、8个mp3及1个wav音频素材。共145个文件压缩包约57.36MB其中tlog、obj为编译中间产物pdb、ilk用于调试有助于了解VS工程构建流程。项目覆盖人机对战与人人对战两种模式人机部分涉及Minimax或Alpha-Beta剪枝等搜索算法的落地网络对战相关概念也有涉及。通过完整源码与工程文件学习者可对照棋盘绘制、落子交互、状态管理及AI决策流程理解从控制台程序到图形化应用的实现路径目录结构清晰便于二次开发与课堂讲评。已有1685人学习下载适合作为C语言综合实践或课程设计的参考项目。1. C语言五子棋配 EasyX为什么这是最适合练手的图形化项目C 语言写五子棋配上 EasyX 图形库几乎是每个计算机专业学生绕不过去的一道坎。这不是巧合五子棋的逻辑足够简单——二维数组、坐标映射、四方向扫描刚好卡在学完指针和结构体之后的能力区间而 EasyX 又把 Windows 下繁琐的窗口创建和 GDI 绘图压缩成了几个函数调用。你不需要理解消息循环的底层机制不需要碰 MFC 或 Qt 那套庞杂的类继承体系就能在一个下午把黑棋白棋画到屏幕上再用鼠标点着玩。但恰恰是这种「看起来简单」的错觉让不少人在编译链接、坐标换算、胜负判定这三个地方翻了车。这篇文章的核心是一条完整的落地路径从棋盘数据模型怎么设计到鼠标事件怎么处理再到胜负判定、简单 AI 和悔棋功能最后是我踩过的几个高频坑。如果你正在写课程设计或者想用 C 语言把一个项目做完整、做漂亮这篇能让你少走半天的弯路。代码块全部基于 VS EasyX 的常见做法你复制到工程里改改就能跑。2. 棋盘数据结构与坐标体系把二维数组映射到屏幕像素2.1 为什么棋盘用 15×15 的二维数组而不是一维数组五子棋的核心状态就是「哪个位置上有棋子、是什么颜色」。最直观的模型是一个二维数组board[row][col]取值 0 表示空位1 表示黑棋2 表示白棋。你可能会想用一维数组加索引换算不一样能存吗能但没必要——五子棋的胜负判定要在四个方向横、竖、两个斜线上连续扫描二维数组的下标row和col天然对应棋盘的行列写扫描逻辑时脑子不用做换算出 bug 的概率低得多。另一个需要考虑的是棋盘边界。标准五子棋是 15×15也就是数组开[15][15]下标 014。但我在写判定函数时习惯多包一圈[17][17]下标 115 放真实棋盘第 0 行和第 16 行留空。这样做的原因很朴素——判定连五时向某个方向扫描会越界多包一圈让越界判断和棋子判断可以合并成一个条件下标出界或者位置为空都算「这条线上断了」。少写好几个if代码也干净。2.2 像素坐标换算格子坐标与鼠标坐标的数学关系棋盘画在屏幕上之后鼠标点的是像素坐标而你要落子的是格子坐标这两者之间必须有一套固定的换算规则。我在实现里把棋盘左上角定在(margin, margin)格子边长cellSize取 40 像素那么第row行第col列的格子的中心点像素坐标就是int x margin col * cellSize; int y margin row * cellSize;反过来鼠标点中某个位置(mouseX, mouseY)对应的格子坐标是int col (mouseX - margin) / cellSize; int row (mouseY - margin) / cellSize;注意这里用的是整数除法会向下取整。如果鼠标点在两个格子交界线上它会落到左上那个格子里这在体验上没问题。但有个边界坑如果mouseX小于margin(mouseX - margin) / cellSize是负数数组下标就越界了。所以换算之后必须加合法性检查下标不在 014 范围内就直接丢弃。#define BOARD_SIZE 15 #define CELL_SIZE 40 #define MARGIN 30 typedef struct { int board[BOARD_SIZE][BOARD_SIZE]; // 0空 1黑 2白 int turn; // 当前轮到的玩家 int history[BOARD_SIZE * BOARD_SIZE][2]; // 悔棋用的落子记录 int historyCount; } Game;这段定义里我把棋盘、当前回合和悔棋记录放在同一个结构体里目的是让整个游戏状态可以作为一个整体传递。history数组的每一行存一次落子的row和col悔棋时从historyCount - 1往回退。之所以不用链式栈是因为棋盘落子上限是 225 手固定数组足够而且实现更简单。2.3 用 EasyX 绘制棋盘和棋子的最小代码绘制的核心思路是先画背景和网格线再遍历数组把所有非空位置画成实心圆。用 EasyX 的画线函数和画圆函数就能完成完整代码大致长这样#include graphics.h #include conio.h void drawBoard(Game* game) { // 白底棋盘 setfillcolor(WHITE); solidrectangle(0, 0, MARGIN * 2 BOARD_SIZE * CELL_SIZE, MARGIN * 2 BOARD_SIZE * CELL_SIZE); // 画网格线 setlinecolor(BLACK); for (int i 0; i BOARD_SIZE; i) { // 横线 line(MARGIN, MARGIN i * CELL_SIZE, MARGIN (BOARD_SIZE - 1) * CELL_SIZE, MARGIN i * CELL_SIZE); // 竖线 line(MARGIN i * CELL_SIZE, MARGIN, MARGIN i * CELL_SIZE, MARGIN (BOARD_SIZE - 1) * CELL_SIZE); } // 画棋子 for (int row 0; row BOARD_SIZE; row) { for (int col 0; col BOARD_SIZE; col) { if (game-board[row][col] 0) continue; int x MARGIN col * CELL_SIZE; int y MARGIN row * CELL_SIZE; setfillcolor(game-board[row][col] 1 ? BLACK : WHITE); setlinecolor(game-board[row][col] 1 ? BLACK : WHITE); fillcircle(x, y, CELL_SIZE / 2 - 2); // 留 2 像素缝隙棋子不会糊成一片 } } }这段代码里有几个值得注意的细节。棋子半径取CELL_SIZE / 2 - 2而不是刚好一半是为了让相邻棋子之间保留一条细缝否则黑色的棋子连在一起会像一块墨渍。solidrectangle刷底的坐标计算要覆盖整个棋盘区域漏掉边角会出现上一帧的残影。每次落子后调用drawBoard重绘全量画面虽然效率不算高但对五子棋这种低频交互的场景完全够用。3. 落子、胜负判定与悔棋三块核心逻辑的代码落地3.1 鼠标消息处理与落子函数把 ExMessage 用对EasyX 处理鼠标消息有新旧两套 API。老版本常用MOUSEMSG配合MouseHit()轮询新版本推荐ExMessage配合peekmessage()。我建议直接用新 API因为它在处理「按下」和「抬起」的区分上更清晰而且以后如果要在同一个窗口里加键盘快捷键代码结构不用推翻重来。#include graphics.h ExMessage msg; while (true) { // peekmessage 非阻塞没有消息时立即返回 0 if (peekmessage(msg, EX_MOUSE)) { if (msg.message WM_LBUTTONDOWN) { int col (msg.x - MARGIN) / CELL_SIZE; int row (msg.y - MARGIN) / CELL_SIZE; if (placePiece(game, row, col)) { drawBoard(game); // 落子后立刻判定胜负 if (checkWin(game, row, col)) { // 游戏结束显示胜方 break; } game.turn 3 - game.turn; // 黑 1 白 23 - turn 在两者间切换 } } } }placePiece的核心逻辑只有三件事坐标越界检查、落子点是否为空、写入数组。很多新手在写这一块时会把坐标换算和落子判断混在一起看起来省了几行代码但调试时很难定位问题。我习惯拆成两个函数——screenToBoard只做换算placePiece只做合法性判断和写入。int placePiece(Game* game, int row, int col) { if (row 0 || row BOARD_SIZE || col 0 || col BOARD_SIZE) return 0; // 越界 if (game-board[row][col] ! 0) return 0; // 已有棋子 game-board[row][col] game-turn; game-history[game-historyCount][0] row; game-history[game-historyCount][1] col; game-historyCount; return 1; }这里把图色棋子的颜色和turn值绑定黑棋固定为 1白棋固定为 2。3 - game-turn这个写法是五子棋以及很多双人回合制游戏的经典做法因为 1 和 2 关于 3 对称减法一下就能切换不用写if判断。3.2 胜负判定四方向扫描的写法与参数化技巧胜负判定的标准写法是以刚落下的棋子为中心分别检查水平、垂直、主对角线、副对角线四个方向统计每个方向上连续同色棋子的数量只要有一个方向达到 5 就判胜。这里的坑在于「连续」两个字——你必须从落子点向两个相反方向各扫描一遍再把数量加起来。int checkWin(Game* game, int row, int col) { int color game-board[row][col]; // 四个方向水平、垂直、主对角线、副对角线 int dirs[4][2] {{0, 1}, {1, 0}, {1, 1}, {1, -1}}; for (int d 0; d 4; d) { int count 1; // 算上刚落下的这颗 // 正向扫描 for (int step 1; ; step) { int nr row dirs[d][0] * step; int nc col dirs[d][1] * step; if (nr 0 || nr BOARD_SIZE || nc 0 || nc BOARD_SIZE) break; if (game-board[nr][nc] ! color) break; count; } // 反向扫描 for (int step 1; ; step) { int nr row - dirs[d][0] * step; int nc col - dirs[d][1] * step; if (nr 0 || nr BOARD_SIZE || nc 0 || nc BOARD_SIZE) break; if (game-board[nr][nc] ! color) break; count; } if (count 5) return 1; } return 0; }这段代码用方向数组dirs把四个方向的扫描收敛到同一个循环里避免了写四段几乎一模一样的代码。你可能注意到我没有单独处理边界——当扫描越界时直接break因为棋盘外的位置不可能是同色棋子。有一种更取巧的写法是给数组加一圈「哨兵值」把边界判断也省掉但我个人不推荐哨兵值会让数组的含义变得不那么直观而且BOARD_SIZE宏在很多地方要用多包一圈之后所有循环边界都得改得不偿失。胜负判定放在checkWin被调用之前游戏状态已经写进数组了所以即使判胜后没有来得及切换回合也不影响结果。但如果要做「五子连珠后的动画特效」需要知道是哪一条线连成的可以把dirs[d]的方向信息记录传递出去这里就不展开了。3.3 悔棋与撤销用数组模拟栈实现后悔药悔棋是五子棋项目里被问得最多的功能之一。实现思路其实很简单每次落子时把位置压入history数组悔棋时从数组尾部弹出最近的一次落子把那格清零再把回合切换回去。注意白棋悔棋和黑棋悔棋要分别处理——白棋悔棋后应该轮到白棋走所以turn也要回退。int undoMove(Game* game) { if (game-historyCount 0) return 0; // 没有可悔的棋 game-historyCount--; int row game-history[game-historyCount][0]; int col game-history[game-historyCount][1]; game-board[row][col] 0; game-turn 3 - game-turn; // 回合回到上一步的人 return 1; }一个容易被忽略的细节悔棋之后必须要重绘棋盘。因为棋盘数组变了但画面还停留在上一帧。在实现悔棋的快捷键时可以选择监听键盘比如按 Backspace 触发undoMove或者做一个按钮区域判断鼠标点击。键盘监听用peekmessage(msg, EX_KEY)注意EX_KEY和EX_MOUSE可以同时传给peekmessage这样一次循环里既能处理鼠标也能处理键盘。这里有个习惯建议悔棋只记录落子位置不记录回合和时间戳。如果你还想做「悔 N 步」那就把historyCount往前多倒退几次就行但要注意一次悔到对方回合这种边界状态——玩家连续悔棋两次棋局就该回到同一个玩家连续走两步的状态这在规则上说不通。所以如果你做双人模式悔棋一次就够了做单人人机模式的时候你甚至可以限制只有玩家能悔棋。4. 简单人机对战让电脑陪你下完一整局4.1 打分函数每个空位值多少分人机对战是五子棋项目里最容易让项目「看起来高级」的功能。最简单的 AI 思路不是搜索博弈树而是给每个空位打分然后选分数最高的位置落子。打分规则可以设计成遍历某个空位在四个方向上能形成的连子潜力比如空位周围已经有 2 个己方棋子这个位置就是「活二」的延伸点得 20 分如果已经有 3 个己方棋子那就是「活三」的延伸点得 100 分如果下一手就能连成 4 个甚至 5 个分数直接拉满。int evaluatePosition(Game* game, int row, int col, int color) { int total 0; int dirs[4][2] {{0, 1}, {1, 0}, {1, 1}, {1, -1}}; for (int d 0; d 4; d) { int count 1; // 当前空位假设已经落子 int openEnds 0; // 两端是否开放 // 正向延伸 int nr row dirs[d][0]; int nc col dirs[d][1]; while (nr 0 nr BOARD_SIZE nc 0 nc BOARD_SIZE game-board[nr][nc] color) { count; nr dirs[d][0]; nc dirs[d][1]; } if (nr 0 nr BOARD_SIZE nc 0 nc BOARD_SIZE game-board[nr][nc] 0) openEnds; // 反向延伸 nr row - dirs[d][0]; nc col - dirs[d][1]; while (nr 0 nr BOARD_SIZE nc 0 nc BOARD_SIZE game-board[nr][nc] color) { count; nr - dirs[d][0]; nc - dirs[d][1]; } if (nr 0 nr BOARD_SIZE nc 0 nc BOARD_SIZE game-board[nr][nc] 0) openEnds; // 根据连子数和开放端数量给分 if (count 5) total 100000; else if (count 4) total (openEnds 2) ? 10000 : (openEnds 1 ? 1000 : 0); else if (count 3) total (openEnds 2) ? 500 : (openEnds 1 ? 100 : 0); else if (count 2) total (openEnds 2) ? 50 : (openEnds 1 ? 10 : 0); else if (count 1) total 1; } return total; }这段代码的思路是先假设这个空位放了color颜色的棋子然后看四个方向各能连成多长的链再看链的两端是不是空的。两端都空的叫「活」只有一端空叫「眠」。活三和眠三的差距在实战中是巨大的——活三下一步就是活四对方必须堵眠三对方可能直接不理。所以分数上必须拉开一个量级。4.2 电脑落子遍历全盘找最大值有了打分函数电脑落子就变成了一个简单的遍历void aiMove(Game* game) { int bestRow -1, bestCol -1; int bestScore -1; // 先看自己有没有能直接赢的位置 for (int r 0; r BOARD_SIZE; r) { for (int c 0; c BOARD_SIZE; c) { if (game-board[r][c] ! 0) continue; int score evaluatePosition(game, r, c, game-turn); if (score bestScore) { bestScore score; bestRow r; bestCol c; } } } placePiece(game, bestRow, bestCol); }这里有一个很严重的隐患AI 只能看到自己赢看不到玩家下一步要赢。比如玩家已经形成活三AI 如果只评估自己位置的分数可能会在另一边发展自己的攻势结果玩家一步连五直接带走。这个问题的常规解法是AI 遍历空位时分别用「自己颜色」和「对手颜色」各评估一次两个分数相加并且给「阻止对手赢」的权重设得更高。int scoreSelf evaluatePosition(game, r, c, aiColor); int scoreOpp evaluatePosition(game, r, c, playerColor); int score scoreSelf * 1 scoreOpp * 2; // 防守权重更高权重的具体数值需要调。我一般先让scoreOpp乘 2 起步如果发现 AI 太怂、总是跟着玩家走再慢慢降到 1.5 或 1.3。这个参数没有标准答案和打分函数的具体数值绑定。你在自己的项目里调的时候建议把每个空位的最终分数打印出来看能非常直观地理解 AI「在想什么」。4.3 让 AI 有「性格」随机扰动与难度分级如果 AI 每次都选分数最高的点下多了你会发现它的棋风很死板——永远堵或者永远冲缺少变化。加一点随机性可以让它更像真人比如在所有分数超过最高分 80% 的位置里随机选一个。这个扰动不会让 AI 变弱太多但会让棋局每次都不一样。// 收集所有超过阈值的位置 srand(time(NULL)); int threshold bestScore * 8 / 10; int candidates[BOARD_SIZE * BOARD_SIZE][2]; int candCount 0; for (int r 0; r BOARD_SIZE; r) { for (int c 0; c BOARD_SIZE; c) { if (game-board[r][c] ! 0) continue; int s /* 上述综合打分 */; if (s threshold) { candidates[candCount][0] r; candidates[candCount][1] c; candCount; } } } int pick rand() % candCount; placePiece(game, candidates[pick][0], candidates[pick][1]);难度分级也可以在这里做简单模式随机选中等模式选综合分的最大值困难模式在最大值和次大值里做更精细的取舍比如优先防守对手的活三。你不需要写复杂的搜索树靠打分函数加随机阈值就能分出不小于三个难度档位这对课程设计来说已经非常够用了。5. 从编译到运行的高频坑链接报错、窗口消失与输入阻塞5.1 链接报错找不到graphics.lib或easyx.h现象代码里#include graphics.h后编译报错或者链接时提示无法解析的外部符号_initgraph。原因通常是两种情况EasyX 没有安装或者安装后 VS 的包含目录/库目录没有设置对。EasyX 的安装包一般会自动配置包含路径但有些精简版或者绿色版 VS 不会修改全局配置。解决打开 EasyX 的安装目录一般是C:\EasyX\或安装时指定的路径手动把include和lib路径加进 VS 工程属性里的「VC 目录」。另一个更省事的办法是在源码里直接指定#pragma comment(lib, graphics.lib)这一行写在#include graphics.h之后告诉链接器去默认路径找库文件。如果你的 EasyX 目录不在默认搜索路径还是要去工程设置里加。遇到这种情况不要怀疑人生绝大多数是路径问题而不是代码问题。5.2 窗口一闪而过控制台程序没有进入消息循环现象运行程序后窗口闪一下就消失了。原因main函数执行完initgraph创建窗口没等用户点什么就直接跑到return 0进程结束窗口自然销毁。新手如果在initgraph之后只写了一句drawBoard就会出现这个现象。解决主循环用while (true)包裹并在循环里调用peekmessage阻塞等待消息。或者更简单——在程序结尾加一句getchar()但从工程质量角度看还是写消息循环更合理。另外很多人的 main 函数写成void main()这在 VS 里能编译过但标准 C 不认强烈建议改成int main()并在程序结束前closegraph()。5.3 peekmessage 与阻塞缓冲为什么鼠标点了没反应或卡顿现象鼠标点击没反应或者画面卡住不动过一会儿突然把之前攒的点击全执行了。原因peekmessage是非阻塞的没消息时立即返回 0如果主循环里没有SleepCPU 占用会拉满系统事件处理不过来另一种情况是用了getmessage阻塞式但还在同一循环里处理高频绘制导致消息积压。解决主循环里加Sleep(10)之类的短延时让出 CPU 给系统处理消息。如果用的是getmessage就不要在同一线程里做重活或者改用peekmessageSleep的组合。这里有个经验EasyX 的peekmessage拿到消息后你处理完要手动调用flushmessage清空缓冲区老 API 的做法新 API 下peekmessage默认会把消息从队列里取走不需要单独 flush但如果你用MouseHit()那套老接口读完消息后不 flush 就会导致下一次读取还是同一条旧消息。5.4 中文字符乱码Windows 控制台与 EasyX 的编码之争现象用outtextxy在窗口里显示中文文字显示出来是乱码。原因EasyX 的outtextxy默认接收的是宽字符wchar_t而源文件的编码格式如果是 GBK直接传字符串字面量会出现编码不一致。解决在字符串前加_T()宏或者直接使用宽字符字符串settextstyle(24, 0, _T(宋体)); outtextxy(10, 10, _T(黑棋落子));如果你的 VS 工程文件编码是 UTF-8那么_T(黑棋落子)在狭窄字符环境下可能还是有问题。最稳妥的办法是把源文件另存为「Unicode (UTF-8 带签名)」格式或者在项目属性里把「字符集」设为「使用 Unicode 字符集」。这不算 EasyX 的问题是 Windows 中文环境下的经典玄学遇到了不要死磕代码逻辑优先检查编码。5.5 双缓冲与闪烁画面抖到怀疑人生现象落子后画面会闪烁尤其是棋子多的时候。原因每次drawBoard都是先刷白底再画网格再画棋子屏幕会经历「清空 → 重画」两个阶段肉眼就能看到闪烁。解决用 EasyX 的双缓冲 APIBeginBatchDraw(); // 开始批量绘制 drawBoard(game); // 所有绘制操作在内存缓冲里进行 FlushBatchDraw(); // 一次性将缓冲内容怼到屏幕上这两行加在main函数最开始和每次绘制之后即可。注意BeginBatchDraw和FlushBatchDraw必须成对出现——如果你只调用了前者而遗漏了后者画面会一直黑屏或保持旧内容不更新。这个函数配对在调试时特别容易忘建议写完drawBoard的调用处就顺手检查一下。6. 画布渲染的进阶技巧帧率、视觉反馈与扩展方向当你的五子棋项目「能玩」之后真正拉开差距的是视觉细节。第一个值得做的改进是落子动画——不是真的做逐帧动画而是利用 EasyX 的fillcircle配合Sleep做一个简单的「从空心到实心」的缩放效果每次落子时画三五个逐渐变大的圆看起来就有「棋子落定」的质感。代价是每次落子多几十毫秒的耗时人眼感知不到卡顿但观感提升非常明显。第二个改进是「最后一手标记」。在最新落子的位置画一个红色小方框玩家能一眼看出当前棋局推进到哪一步。实现很简单在drawBoard函数的末尾取history[historyCount - 1]的位置用setlinecolor(RED)画一个小矩形即可。这个功能在人机对战时尤其重要——AI 落子后玩家需要快速定位电脑下在哪。第三个值得投入的方向是「胜利高亮」。判断出胜负后不要直接弹窗结束而是把连成五颗子的一条链用不同颜色标出来让玩家看到自己赢在哪一条线上。实现思路是checkWin里在找到count 5的方向后记录下从起点到终点的所有坐标然后画一圈高亮边框。这个功能对课程设计的评分帮助很大因为它直观地展示了「代码检测到了什么」。帧率方面五子棋棋盘重绘的开销其实不大即使全量重绘也用不了多少 CPU。但如果你的窗口尺寸很大、棋盘的margin和cellSize没配合好可能会出现切边问题。我习惯把窗口尺寸设成MARGIN * 2 (BOARD_SIZE - 1) * CELL_SIZE CELL_SIZE确保最右边一列棋子的圆心不会被窗口边缘裁掉。具体公式窗口宽度 MARGIN * 2 (BOARD_SIZE - 1) * CELL_SIZE CELL_SIZE这样坐标从MARGIN到MARGIN (BOARD_SIZE - 1) * CELL_SIZE加上棋子半径CELL_SIZE / 2后还有CELL_SIZE / 2的余量完美容纳所有棋子的绘制。我见过不少人把棋盘尺寸写死成 600×600然后改cellSize的时候忘了同步改窗口尺寸结果棋子画到屏幕外面去了。参数之间做好联动用一个宏定义而不是把数字散落在代码各处的习惯是这类项目少踩坑的关键。最后一个建议给项目加个 README 文件把规则、编译方式比如「用 VS2019 打开安装 EasyX 后直接 F5 运行」、操作说明鼠标左键落子Backspace 悔棋写清楚。这样不管是自己以后翻代码还是给课程设计的评审看都能省很多沟通成本。从棋盘数据结构到 AI 落子这套代码量大约 400 行上下全部用 C 语言写不涉及 C 的类特性只用了 EasyX 的绘图和消息接口。如果你正在做这个方向我的习惯是先让双人对战完整跑通保存好这第一个「能玩」的版本再往上加 AI 和动画。这样每加一层功能都有一版稳定可回退的基线。希望这篇能帮到你下棋愉快。本文还有配套的精品资源点击获取
