C语言+EasyX五子棋实战：双缓冲、坐标吸附与五连判定

简介C语言五子棋EasyX项目面向希望用C语言完成图形化小游戏的初学者与进阶学习者借助EasyX图形库将棋盘绘制、落子交互与胜负判定落地并延伸出人人对战、人机对战及联机通信等练习场景。压缩包共145个文件、约57.36MB包含6个cpp与5个头文件构成的工程源码、3个可执行程序以及棋盘与界面所需的65张jpg图片、8个mp3和1个wav音频素材同时还保留了obj、pdb、tlog等编译与调试中间文件便于对照工程构建过程。已有1689人学习下载。读者可从中梳理EasyX初始化、图形绘制和事件循环的实现方式理解五子棋状态管理与落子合法性判断并参考Minimax、Alpha-Beta剪枝等AI搜索思路联机部分则提供socket通信与多客户端同步的学习线索适合做课程设计或C语言综合实践时拆解复用。1. 一个 C 语言五子棋卡住新手的从来不是算法很多人第一次拿C 语言写五子棋以为难点在胜负判定真正把项目卡死的往往是EasyX那一层的工程配置窗口闪一下就退、鼠标点下去偏半格、棋子画成方块、改了颜色却不生效。这套「星空系列」的资源就是冲着这些具体故障去的一个能编译、能点、能悔棋、能判胜负的 15×15 图形化五子棋棋盘用深空底色加星位提示落子和最后一手都有明确视觉反馈。它适合三类人学过 C 语法但没做过完整图形程序的学生想拿一个能跑的小项目练手工程结构的初学者以及需要一份干净双人对战骨架、之后自己往上叠 AI 的开发者。下面按「搭起来、点得准、判得对、不翻车」的顺序拆。2. 把 EasyX 挂进 C 工程编译链路与首帧窗口这一章要解决的问题很朴素让一个.c文件在 Windows 上弹出一个稳定的 680×680 窗口鼠标点下去能在控制台打印坐标。听起来简单但工程配置、字符集、绘制模式三处任意一处不对后面全部白干。2.1 选 EasyX 的理由以及它明确的天花板EasyX 本质是对 Windows GDI 的一层薄封装头文件easyx.h加上一个静态库几个函数就能画线、画圆、贴图、读鼠标。对于五子棋这种只涉及线条和圆形的 2D 棋盘游戏它是性价比最高的选择不需要额外依赖不需要写窗口过程不需要管理渲染管线。选型的另一面也要说清楚。它只在 Windows 上可用换到其他系统直接编不过它没有硬件加速一帧画几千个图形就开始吃力它的坐标系是整数像素做缩放和旋转很别扭。所以这套方案的边界是本地双人对战、固定窗口尺寸、图形元素在几百个量级。一旦你要做联网对战或者带搜索深度的 AI图形库的性能就不是瓶颈了瓶颈会转移到搜索算法上那时候 EasyX 依然够用。对比另外两条路纯控制台版本画不出棋盘用户体验差也练不到事件循环SDL 或 OpenGL 更通用但配环境和写初始化代码的成本对初学者是劝退级的。我一般会建议先用 EasyX 把「能玩」这件事做出来再考虑通用性。2.2 把库挂进 C 工程三个真正会出错的配置点第一步是建工程。Visual Studio 里新建空项目添加一个.c后缀的源文件而不是.cpp。这一步不是洁癖.cpp会按 C 规则做名字修饰一旦你后面混入第三方 C 库链接阶段就会报 LNK2019 找不到符号排查起来很费时间。整个工程统一用.c规则最简单。第二步是让编译器找到头文件。EasyX 安装时会往 VS 的头文件目录里写东西但换机器或者换 VS 版本后经常失效。稳妥做法是把easyx.h、graphics.h拷到工程目录下用双引号包含库文件EasyXa.lib静态或EasyXw.lib动态加到「附加依赖项」库目录指向工程下的lib文件夹。这样整个工程可以打包带走换电脑不用重装。第三步是字符集。VS 新建工程默认是 Unicode 字符集而 EasyX 的文字接口参数类型是LPCTSTR你在 C 里传一个char*字符串字面量编译直接报「无法从 const char[] 转换为 LPCTSTR」。解决办法两个项目属性 → 配置属性 → 高级 → 字符集改成「使用多字节字符集」或者在代码里用_T(...)宏包一层。我倾向第一种因为整份代码看起来更干净不用到处加宏。提示这三个配置点建议一次性写进工程的 README换机器重配的时候照着做比凭记忆试错快得多。2.3 最小可跑骨架双缓冲加消息泵骨架的作用是把「窗口不闪、鼠标能收、ESC 能退」这三件事一次做对。下面这段是可以直接编译运行的#include graphics.h #include conio.h #include stdio.h #define WIN_W 680 #define WIN_H 680 int main(void) { /* 第三个参数 EX_SHOWCONSOLE 保留控制台printf 调试非常有用 */ initgraph(WIN_W, WIN_H, EX_SHOWCONSOLE); setbkcolor(RGB(10, 14, 34)); /* 星空底色深蓝偏黑 */ cleardevice(); BeginBatchDraw(); /* 进入批量绘制之后所有绘制先写进内存 DC */ int running 1; while (running) { ExMessage msg; /* peekmessage 是非阻塞的一次把队列里的消息取干净 */ while (peekmessage(msg, EX_MOUSE | EX_KEY)) { if (msg.message WM_KEYDOWN msg.vkcode VK_ESCAPE) { running 0; } if (msg.message WM_LBUTTONDOWN) { printf(click at %d, %d\n, msg.x, msg.y); } } FlushBatchDraw(); /* 这一帧真正贴到窗口上 */ Sleep(10); /* 约 100 帧上限避免空转吃满一个核 */ } EndBatchDraw(); closegraph(); return 0; }逻辑说明BeginBatchDraw和FlushBatchDraw是成对的前者把绘制目标切到后台缓冲区后者一次性提交。没有这一对每调用一次绘图函数就刷新一次屏幕画面会明显闪烁这是新手最常见的「血泪经验」之一。参数说明peekmessage的第二个参数是消息过滤器这里只要鼠标和键盘。很多人图省事传EX_ALL或者干脆用getmessage结果窗口的关闭消息被吞掉点右上角红叉没反应还得去任务管理器杀进程。2.4 帧率与输入节奏Sleep(10)决定了主循环的节奏。五子棋是回合制对帧率几乎没有要求10 毫秒足够让鼠标响应看起来跟手又不会让 CPU 占用飙到 25%。如果想做落子动画或者最后一手的呼吸效果可以降到 16约 60 帧但别写成Sleep(0)那样循环跑满风扇会转起来。还有一个细节输入处理要放在绘制之前而且每帧都要把消息队列清空。如果只在某个分支里调peekmessage快速点击时后面的消息会堆积表现为「点两下只落一子」这属于典型的输入节奏问题不是逻辑 bug。3. 从鼠标像素到棋盘格点15×15 数组、坐标吸附与重绘棋盘是这套代码里唯一需要认真设计的地方。数据结构选错后面判定、悔棋、复盘全都要返工坐标换算写错用户会觉得这个游戏「手感很怪」。3.1 先把尺寸常量算死再谈绘制15×15 的标准棋盘有 14 个格子间隔加上两边留白窗口边长必须是2 * MARGIN (SIZE - 1) * GRID。用MARGIN 60、GRID 40得到 120 560 680。这三个常量一旦定下initgraph的宽高、坐标换算、重绘区域全部由它们推导后面改尺寸只改这三个数。#define SIZE 15 /* 15 路棋盘 */ #define GRID 40 /* 格距 40 像素 */ #define MARGIN 60 /* 棋盘到窗口边缘的留白 */ /* 棋盘状态0 空、1 黑、2 白。用 int 而不是 char读写更省心 */ int board[SIZE][SIZE];数据结构上没什么玄学就是二维数组。唯一值得提醒的是别用全局变量到处乱改后面加悔棋和复盘的时候所有落子必须走同一个函数否则很容易出现数组和记录栈不一致的情况。3.2 像素坐标到行列号的换算与吸附这一步是「点不准」的根源。C 的整数除法是向零截断的直接写(x - MARGIN) / GRID会让每个格子的有效区域整体偏左半格用户点在交叉点右侧 19 像素还能命中左侧只差 1 像素就跳到上一格手感非常怪。正确做法是先加半格再除然后做吸附半径判断。/* 成功返回 0点在棋盘外或离交叉点太远返回 -1 */ int pixel_to_grid(int x, int y, int *row, int *col) { /* 加 GRID/2 再整除等价于四舍五入到最近的格点 */ int c (x - MARGIN GRID / 2) / GRID; int r (y - MARGIN GRID / 2) / GRID; if (r 0 || r SIZE || c 0 || c SIZE) return -1; /* 吸附半径取 0.45 格超过就认为点空了防止误触 */ int dx x - (MARGIN c * GRID); int dy y - (MARGIN r * GRID); int limit GRID * 45 / 100; if (dx * dx dy * dy limit * limit) return -1; *row r; *col c; return 0; }参数说明limit用GRID * 45 / 100而不是浮点是为了避免引入math.h和浮点比较用平方比较距离也省掉了开方。这段代码是纯函数不碰全局状态可以单独拿出来跑测试这一点对后面第 6 章很关键。3.3 一帧的绘制顺序背景、棋盘、星位、棋子、最后一手绘制顺序错了会出现覆盖问题比如先画棋子再画棋盘线线就压在棋子上。正确的顺序是清屏 → 星空背景 → 棋盘线 → 星位 → 棋子 → 最后一手标记。void draw_board(void) { cleardevice(); /* 1. 星空背景固定种子保证每帧星点位置一致否则画面会“沙沙”抖 */ srand(2024); for (int i 0; i 160; i) { int sx rand() % WIN_W; int sy rand() % WIN_H; int rr rand() % 2; setfillcolor(RGB(120 rr * 60, 140 rr * 50, 200)); solidcircle(sx, sy, rr 1); } /* 2. 棋盘线颜色设在循环外循环里反复设置会拖慢绘制 */ setlinecolor(RGB(80, 110, 170)); for (int i 0; i SIZE; i) { int p MARGIN i * GRID; line(MARGIN, p, MARGIN (SIZE - 1) * GRID, p); /* 横线 */ line(p, MARGIN, p, MARGIN (SIZE - 1) * GRID); /* 竖线 */ } /* 3. 星位天元加四角星五子棋的标准视觉锚点 */ setfillcolor(RGB(160, 200, 255)); int stars[5][2] {{7,7},{3,3},{3,11},{11,3},{11,11}}; for (int i 0; i 5; i) { solidcircle(MARGIN stars[i][1] * GRID, MARGIN stars[i][0] * GRID, 3); } }背景星点用固定种子这一点值得单独说。如果每帧都srand(time(NULL))星点位置会随机跳整块背景像下雪一样闪视觉上很廉价。固定种子之后背景是静态的只有棋子在动这才是「星空皮肤」该有的样子。棋子的绘制用两个同心圆做出球感void draw_piece(int r, int c, int who) { int cx MARGIN c * GRID; int cy MARGIN r * GRID; if (who 1) { /* 黑子 */ setfillcolor(RGB(22, 24, 34)); solidcircle(cx, cy, GRID / 2 - 3); setfillcolor(RGB(95, 100, 118)); /* 左上高光 */ solidcircle(cx - 4, cy - 4, 3); } else { /* 白子 */ setfillcolor(RGB(232, 236, 245)); solidcircle(cx, cy, GRID / 2 - 3); setfillcolor(RGB(182, 188, 202)); solidcircle(cx 4, cy 4, 3); } }GRID / 2 - 3里的 3 是让棋子比格子略小一圈的留白不留的话相邻棋子会贴在一起边界看不清。高光位置左右镜像黑子光在左上、白子暗在右下符合默认光源在左上的直觉。3.4 落子流程与合法性收口一帧里真正要做的判断只有四条游戏是否已结束、目标格是否越界、目标格是否已有子、轮到谁。这四条判断集中在一个函数里任何输入路径都必须经过它包括鼠标点击、键盘方向键加回车、以及以后的 AI 落子。int place(int r, int c, int who) { if (r 0 || r SIZE || c 0 || c SIZE) return -1; /* 越界 */ if (board[r][c] ! 0) return -2; /* 已有子 */ board[r][c] who; return 0; }返回值区分错误类型是为了让上层能给出不同反馈越界一般是坐标换算出了问题应该记日志已有子则是正常用户误触提示一下就行。把这两种情况混成同一个返回值出问题的时候就少了一条线索。4. 五连判定的工程量只查最后一手四个方向各走两遍判定逻辑是这套代码里唯一有算法味道的部分也是很多人写错的地方。写错的形态无非两种漏判斜线方向没覆盖和越界数组下标跑到 -1 或者 15程序直接崩。4.1 全盘扫描为什么是个坏做法最直观的写法是每次落子后把 225 个格子遍历一遍对每个格子朝四个方向数连续同色子。这个写法能跑对但每步要比较约 900 次而且每次都要处理边界。更麻烦的是它把「刚刚落下的这一手」这个最有价值的信息丢掉了——只有新落的这颗子才可能构成新的五连之前所有的连续段在上一回合就已经判过了。正确的做法是只从最后一手出发四个方向各向两端延伸计数。单步比较次数降到 30 次左右代码反而更短边界判断也更集中。这是典型的「用结构换性能」而且不用任何额外状态。4.2 四方向双向计数实现四个方向是横、竖、主对角线、副对角线。用一张方向表描述避免写四段几乎一样的for循环/* 四个方向右、下、右下、右上。反方向用 -1 乘以这个向量得到 */ static const int DIR[4][2] {{0, 1}, {1, 0}, {1, 1}, {1, -1}}; int check_win(int r, int c, int who) { for (int d 0; d 4; d) { int cnt 1; /* 算上新落的这一颗 */ for (int s -1; s 1; s 2) { /* s -1 反向s 1 正向 */ int rr r DIR[d][0] * s; int cc c DIR[d][1] * s; while (rr 0 rr SIZE cc 0 cc SIZE board[rr][cc] who) { cnt; rr DIR[d][0] * s; cc DIR[d][1] * s; } } if (cnt 5) return 1; } return 0; }逻辑说明以落子点为中心沿某个方向向两侧各走一遍走过的同色子计数累加。(1, -1)这个方向覆盖右上到左下和(1, 1)一起把两条对角线都包住了不需要八方向。参数说明cnt 5而不是 5是因为长连六子以上在无禁手规则下也算赢。如果你的规则里带禁手这里要改成 5并把长连判负那是另一套逻辑别混着改。注意while的循环条件里边界判断必须放在board[rr][cc]之前。C 的有短路求值顺序写反了就会先访问越界下标程序可能不崩但读出随机值判定结果时对时错。4.3 状态机与平局、长连的边界胜负判定之外还要维护一个游戏状态用枚举比用int标志位清晰得多enum GameState { PLAYING, BLACK_WIN, WHITE_WIN, DRAW }; enum GameState state PLAYING; /* 落子后调用统一更新状态 */ void update_state(int r, int c, int who, int move_count) { if (check_win(r, c, who)) { state (who 1) ? BLACK_WIN : WHITE_WIN; } else if (move_count SIZE * SIZE) { state DRAW; /* 棋盘填满且无人五连 */ } }move_count用一个独立计数器维护比每次遍历数组统计非零格更省事也不容易漏。状态一旦不是PLAYING输入处理必须直接 return否则玩家还能继续落子棋盘上会多出莫名其妙的棋子。这个细节在新手代码里极其常见。4.4 悔棋与重开把状态改回去比改过来难悔棋的坑在于「改回去」比「改过来」多好几个动作数组要清、计数器要减、当前执子方要切、状态要复位、最后一手标记要回退。少做任何一个都会出现「悔棋之后还能继续下但赢了不判」这类诡异问题。typedef struct { int row[SIZE * SIZE]; int col[SIZE * SIZE]; int top; /* 栈顶也是已落子数 */ } MoveStack; int undo(MoveStack *ms, int *cur) { if (ms-top 0) return -1; /* 空栈没得悔 */ ms-top--; board[ms-row[ms-top]][ms-col[ms-top]] 0; *cur 3 - *cur; /* 1 变 22 变 1 */ state PLAYING; /* 悔棋后一定回到对局中 */ return 0; }3 - *cur这个写法比if/else分支短前提是棋子编号严格用 1 和 2。如果哪天改成 0 和 1这一行会变成隐蔽的 bug所以要么在宏里把编号定义清楚要么老老实实写分支。重开则是把整块内存清零memset(board, 0, sizeof(board))然后栈顶、计数器、状态、当前执子方一起复位。注意是sizeof(board)而不是sizeof(board[0])后者只清第一行剩下的 14 行还是上一局的残局这种错误肉眼很难看出来。5. 避坑清单五个让五子棋白屏、点歪、闪退的具体故障这一章是我在反复重装环境、改配置、抓鼠标坐标时攒下来的。每一条都按「现象 → 原因 → 解决」写遇到对应症状可以直接对照。5.1 窗口一闪就消失或者一片纯色现象双击 exe窗口出现不到一秒就没了或者干脆是个纯色矩形什么都没有。原因initgraph之后直接return 0没有主循环或者用了BeginBatchDraw但忘了在循环里调FlushBatchDraw所有绘制都停在后台缓冲里从来没提交到屏幕。解决检查主循环是否存在、是否有个能让循环持续的条件检查FlushBatchDraw是否在while内部。如果用了getmessage这种阻塞式取消息它本身不会返回绘制就被卡住了——回合制游戏应使用非阻塞的peekmessage自己控制节奏。5.2 鼠标明明点在交叉点上棋子却落在隔壁现象点击位置和落子位置系统性偏移越靠右、越靠下偏得越多。原因两个可能。一是整数除法截断没做四舍五入偏移量恒定半格二是高分屏的 DPI 缩放系统把窗口放大了 125% 或 150%但你拿到的鼠标坐标是逻辑坐标绘制时用的却是物理像素。解决坐标换算改成先加GRID/2再整除。DPI 问题在main开头调一次SetProcessDPIAware()需要包含windows.h让进程自己按物理像素处理缩放就不再干扰坐标。5.3 棋子画出来是个实心方块或者改了颜色不生效现象setfillcolor明明设了深色画出来还是默认的白色圆或者setlinecolor改了填充色纹丝不动。原因EasyX 的circle和solidcircle是两个函数。circle用的是线条色setlinecolorsolidcircle用的是填充色setfillcolor。想画实心棋子却调了circle得到的就是空心中空圆反过来把setlinecolor当填充色改当然没反应。解决实心棋子和星位统一用solidcircle线框用circle并且明确每个函数读哪个颜色。另外outtextxy的文字颜色由settextcolor控制和线条色、填充色都无关这三件事要分清。5.4 落子之后整屏闪烁或者画面撕裂现象每落一子画面明显闪一下鼠标移动时棋盘出现横向撕裂。原因没有启用批量绘制每次cleardevice加逐条画线都直接刷屏屏幕上看得到绘制过程。解决initgraph之后立刻BeginBatchDraw()主循环末尾FlushBatchDraw()退出前EndBatchDraw()。三者成对出现缺一个都会出问题。另外Sleep别省循环跑太快反而更容易暴露撕裂。5.5 关掉窗口进程还在后台任务管理器里能看到现象点右上角关闭按钮窗口消失了但 exe 还在进程列表里再启动一次会有两个。原因peekmessage的过滤器只写了EX_MOUSE | EX_KEY窗口消息被过滤掉程序收不到关闭通知或者收到了WM_CLOSE但没有把循环标志置零。解决在消息循环里显式处理关闭消息把running置 0循环退出后必须调closegraph()释放图形资源。只置标志不closegraph进程能退但资源没释放调试器里会报泄漏警告。6. 复盘文件与判定用例把逻辑从图形库里摘出来再往上加功能最有价值的两件事是复盘和可测试性而不是急着上 AI。复盘的做法很简单把MoveStack按固定文本格式写成文件一行一手行 列 颜色三个字段写入用fprintf(fp, %d %d %d\n, r, c, who)。回放时读回数组用一个定时器每隔 300 毫秒重放一手重放期间屏蔽鼠标输入。这套格式还有一个额外好处出问题时把对局文件发出来别人能在本地完整复现比截图描述直观得多。可测试性优先于功能。pixel_to_grid、check_win、place这三个函数都不依赖任何 EasyX 调用把它们单独放进一个不包含graphics.h的.c文件里就能脱离窗口跑单元测试。我一般会准备一张固定棋型表每次改完判定逻辑先跑一遍棋型落子坐标行, 列期望结果横向五连(7,3) 到 (7,7)判黑胜主对角线五连(5,5) 到 (9,9)判黑胜副对角线五连(9,5) 到 (5,9)判黑胜边角四连补一(0,0) 到 (0,4)判黑胜且不越界崩长连六子(7,3) 到 (7,8)按无禁手规则判胜满盘无五连交替填满判平局这张表覆盖了方向、边界、长连、平局四类边界情况。我踩过最深的一个坑是副对角线当时方向表里写的是{1, 1}和{1, -1}但反向计数时把行和列的符号一起取了反导致(1, -1)变成了(-1, 1)两者其实是同一个方向等于两条对角线只判了一条。棋盘上横向竖向都好使偏偏斜着连五个不认找了大半天。从那以后我每次动胜负判定都先用这张表里的六个用例跑一遍再谈别的。如果你手里正好缺一个能跑的图形化 C 项目这套「星空系列」的五子棋可以直接当骨架用工程配置、双缓冲、坐标吸附、判定状态机、悔棋栈都是现成的你要做的只是把它编译起来然后按自己的规则改。希望帮到你。本文还有配套的精品资源点击获取