C++ MFC跳棋游戏源码解析：从VC6工程到现代编译器的避坑指南

简介跳棋游戏源码压缩包基于 VC/MFC 实现经典中国跳棋玩法面向正在学习 Windows 桌面开发、游戏逻辑与 AI 算法的编程爱好者。包内共 43 个文件涵盖 .cpp 源代码、.h 头文件、.rc 资源脚本以及 .bmp 棋盘素材、.ico 图标、.cur 光标还有 .dsw/.dsp/.plg 等工程文件整体仅 215KB目录结构清晰便于直接打开编译。目前已有 223 人学习下载。源码覆盖棋盘二维数组表示、直线斜线跳与连续跳规则、命令行与图形界面交互、游戏主循环及胜负判断并涉及序列化保存进度、Minimax/AI 搜索和输入校验等主题。通过阅读和修改这份代码能够快速理解 MFC 工程组织方式、图形界面事件响应以及游戏状态机与常用搜索算法的落地写法。1. 跳棋游戏源代码别把它当普通小游戏这是一份能跑的 C/MFC 老工程跳棋游戏源代码这份 zip不是那种几十行的单文件教学脚本而是一个完整的 VC 6.0 时代 MFC 工程。里面有对话框资源、自定义控件、Socket 网络对战模块甚至带着 Debug 输出目录解压之后理论上可以直接编译出一个能玩的跳棋程序。对正在做课程设计、想了解老式桌面游戏架构、或者需要一份 MFC 消息映射和 GDI 绘图参考的人来说这份代码比市面上那些 Python 小游戏源代码要硬核得多——它逼着你面对真实工程的问题预编译头、资源 ID、字符集、控件的消息路由。这不是给你抄的作业是给你拆的标本。2. 先把工程跑起来文件结构、编译环境与迁移思路拿到 zip 的第一步不是打开代码而是把这堆文件按作用分好类。老工程和现在 GitHub 上那些带 CMakeLists 的现代项目不一样它的工程信息散落在 .dsw、.dsp、.opt、.clw 这些后缀里缺一个都可能导致打开失败或编译报错。先把每个文件是什么搞清楚后面踩坑时才知道去哪翻。2.1 从 zip 到工程一份老 MFC 项目的文件解剖解压后你会看到一组典型的 VC6 工程文件我按用途拆成几类方便你对照类别文件名作用工程文件TTQ.DSW、TTQ.DSP、Ttq.opt、TTQ.PLG、ttq.dsp工作区与项目配置决定编译目标与依赖入口与框架Ttq.cpp、ttqDlg.h、ttqDlg.cpp应用程序入口、主对话框类游戏逻辑Tzq.h、Tzq.cpp、Date.h棋盘表示、规则判断、游戏状态新建/关于NewGame.h、NewGame.cpp、AboutDialog.h、AboutDialog.cpp新游戏参数对话框、关于对话框网络模块MySocket.h、MySocket.cpp联机对战用的 Socket 封装资源与辅助ttq.rc、resource.h、StdAfx.h、StdAfx.cpp、ReadMe.txt资源脚本、导出的文档和说明其中 StdAfx.h / StdAfx.cpp 是全工程的地基MFC 工程的预编译头就靠这俩文件。改动里面的 include 会导致整个项目重新编译这是正常现象不是坏了。resource.h 是资源 ID 的集中定义处所有对话框控件、菜单、图标的编号都在这里改的时候要小心 ID 冲突——这几乎是所有 MFC 老工程最常见的翻车点之一。TTQ.PLG 和 Ttq.opt 是 VC6 自动生成的辅助文件前者是编译日志后者是工程选项缓存理论上删了也能重新生成。Debug 目录里是已经编译过的中间文件和 exe如果你用的是老系统解压后甚至可以直接跑那个 exe 看看原版效果。但我强烈建议你自己重新编译一遍只有走过编译流程你才知道哪些平台相关的坑你的环境也会踩。2.2 用 VC6 打开 dsw 的正确姿势工作区、依赖项与首次编译这套代码是为 VC6 准备的最省事的方式就是用 Visual C 6.0 打开 TTQ.DSW 工作区文件。打开后你会看到 ClassView 里按类组织的结构Tzq、ttqDlg、MySocket 这些类一目了然点进去就能跳转到对应实现。按 F7 编译如果环境干净应该能直接生成可执行文件然后在 Build 菜单里执行 Build 或按 CtrlF5 运行。这里有个关键点Debug 目录下已经存在的 .obj 和 .exe 不代表你一定能编过因为每个人的系统环境不同。我一般会先执行一次 CleanBuild 菜单里的 Clean把旧的中间文件清掉再重新 Build避免编译器用了过期的 obj 文件导致各种诡异问题。如果你在较新的 Windows 上装的是 VC6 精简版或绿色版可能会遇到编译器找不到 mspdb60.dll 这类问题那是 VC6 环境变量没配对不是工程本身的问题。编译通过后建议你先跑一局人机对战感受一下完整的对局流程。然后打开代码从 Ttq.cpp 的 InitInstance 开始读——这是 MFC 应用的起点它创建了 ttqDlg 主对话框然后通过 DoModal 进入消息循环。理解了这条线整个程序的骨架就搭起来了。2.3 换到 VS2010 以上版本升级向导之外还要手动处理什么如果你没有 VC6想用新版 Visual Studio 打开这个工程路径也走不通——VS2010 之后的版本不再支持 .dsw 工程文件需要先创建一个新工程再把这些 .cpp 和 .h 文件手动加进来。VS 的升级向导只能处理 .dsp 转 .vcxproj而且转出来的工程大概率会在字符集和头文件依赖上报一堆错。迁移这件事我的经验是不要盲目让版本迁移工具自动处理手动建工程反而可控。新建一个 MFC 对话框应用程序把 TTQ.DSW 里的文件拖进项目的 Source Files 和 Header Files 里然后在项目属性里做三件事字符集选“使用多字节字符集”VC6 时代默认 MBCS新版默认 Unicode附加包含目录指向 MFC 头文件路径一般不需要项目-属性-常规里会默认带C/C 语言标准保持默认不要手工调成 C17MFC 老代码经常在新标准下触发编译错误比如从 const char* 到 CString 的隐式转换在新标准下会被判定为更危险的转换。另外要注意新版 VS 对 OnDraw、OnPaint 里的 GDI 对象泄漏检查更严格如果代码里有 CreatePen 或 CreateBrush 没有 DeleteObject编译能过但运行时会闪烁或内存疯涨。后面避坑章节我会单独展开。3. 棋盘与规则二维数组、跳跃判定与回合状态机跳棋的核心不在界面在规则。这份代码里规则部分集中在 Tzq.h 和 Tzq.cpp加上 Date.h 里的数据结构定义。把这三个文件读透你就能理解一个棋类游戏是怎么从“棋盘长什么样”一步步走到“能不能走这步”的。3.1 棋盘的数据结构0/1/2 三种状态如何映射到界面跳棋棋盘是一个 10×10 的格子区域实际可用的位置是 50 个去掉四角和中间空位具体布局要看代码里的初始化函数。在源代码里棋盘通常用一个二维数组保存每个元素存储一个整数0 表示空位1 表示红方棋子2 表示蓝方棋子。你可以在 Date.h 或 Tzq.cpp 的初始化函数里看到类似这样的定义// 棋盘状态定义0空位1红方2蓝方 const int BOARD_SIZE 10; int board[BOARD_SIZE][BOARD_SIZE]; // 初始化默认棋盘布局两军对垒中间两行为空 void InitBoard(int board[BOARD_SIZE][BOARD_SIZE]) { for (int row 0; row BOARD_SIZE; row) { for (int col 0; col BOARD_SIZE; col) { // 红方占据棋盘上方的三角形区域 if ((row 4) IsInTriangle(row, col, 0)) { board[row][col] 1; } // 蓝方占据棋盘下方的三角形区域 else if ((row 6) IsInTriangle(row, col, 1)) { board[row][col] 2; } else { board[row][col] 0; } } } }这段代码里有几个值得注意的参数与逻辑分支。IsInTriangle 函数的作用是判断某个格子是否属于开局布子区域两个三角形区域各占 10 个位置整个棋盘 50 个有效位置其余位置在初始化时被置 0。这个函数通常实现为根据行列坐标计算到顶点的曼哈顿距离来判断边界条件处理不当会导致棋子出现在不该出现的位置——这是首次改代码时常踩的坑。了解了棋盘的存储方式再看界面绘制就简单了。ttqDlg 的 OnPaint 函数里会读取这个二维数组根据每个位置的值绘制对应的棋子图片坐标换算的公式一般是屏幕 X 坐标 起始 X 列索引 × 格子宽度屏幕 Y 坐标 起始 Y 行索引 × 格子高度。这个映射关系直接决定了鼠标点击时能不能反算出正确的行列索引后面处理鼠标消息时还需要用到它。3.2 合法移动的判定直跳、连跳与边界检查的完整实现跳棋最核心的规则是跳跃棋子可以沿六个方向水平、垂直、两条对角线移动或跳跃跳跃时中间必须有对方的棋子作为“桥”跳完后如果新的位置还能继续跳就可以连跳。这个逻辑在源代码里通常会实现为两个层次第一层检查单步移动是否合法第二层检查跳跃是否合法并递归寻找所有可能的连跳路径。一个标准的检查单步移动的代码框架如下从中你能看到源码里 Tzq.cpp 判断逻辑的大致风格// 检查从(fromRow, fromCol)移动到(toRow, toCol)是否合法 bool IsValidMove(int board[BOARD_SIZE][BOARD_SIZE], int fromRow, int fromCol, int toRow, int toCol, int player) { // 先做基础边界检查坐标必须在棋盘有效范围内 if (toRow 0 || toRow BOARD_SIZE || toCol 0 || toCol BOARD_SIZE) return false; // 目标位置必须为空 if (board[toRow][toCol] ! 0) return false; // 源位置必须有己方棋子 if (board[fromRow][fromCol] ! player) return false; int rowDiff toRow - fromRow; int colDiff toCol - fromCol; int absRow abs(rowDiff); int absCol abs(colDiff); // 邻接移动沿六方向走一格不能原地不动 if ((absRow 1 absCol 0) || (absRow 0 absCol 1) || (absRow 1 absCol 1)) { return true; // 简单移动不跨越任何棋子 } // 跳跃移动移动两格中间必须被对方棋子占据 if ((absRow 2 absCol 0) || (absRow 0 absCol 2) || (absRow 2 absCol 2)) { int midRow (fromRow toRow) / 2; int midCol (fromCol toCol) / 2; // 中间棋子必须是对方棋子不能是己方棋子或为空 if (board[midRow][midCol] ! 0 board[midRow][midCol] ! player) { return true; } } return false; }这里的关键参数是 rowDiff 和 colDiff 的绝对值判断。邻接移动只允许移动一格跳跃必须恰好移动两格且中间有对方棋子。很多初学者会把跳跃条件写成 absRow 2 || absCol 2这样会漏掉对角线跳跃的合法判断——两个条件必须同时满足。源码里如果看到类似的 bug记得改过来改完后用“红方从 (3,3) 跳到 (5,5) 中间有蓝子”和“中间无子”两组用例验证一下。连跳的实现一般不需要额外写一个全新的函数常见做法是把单步跳跃做成递归当前棋子跳到一个新位置后以这个新位置为起点重新检查所有方向的跳跃只要存在合法跳跃就继续递归直到没有可跳的位置为止。源码里如果实现了这个逻辑通常会配合一个 visited 数组来记录已经跳过的格子防止出现循环跳跃的死循环。3.3 回合与胜负主循环怎么知道该谁走、什么时候结束棋盘和规则都有了还需要一个状态机控制对局流程轮到谁走、走了几步、是否有人获胜。在 MFC 程序里这个状态机通常以成员变量的形式存在于主对话框类中比如 ttqDlg.h 里会有一个 int m_nCurrentPlayer 或类似的变量值为 1 或 2 分别代表两位玩家。每次玩家点击棋盘上的有效位置后程序会做三件事执行棋子移动、刷新棋盘显示、切换当前玩家。在源码里你可能看到的流程是OnLButtonDown 里调用 Tzq 类提供的 Move 函数Move 返回是否成功成功后调用 Invalidate 触发重绘再把 m_nCurrentPlayer 取反。这里有个隐藏逻辑是连跳的处理在移动过程中会多次更新棋盘如果 Move 函数内部没有处理好中间状态的显示用户会看到棋子瞬移而不是逐步跳跃影响体验。胜负判断的实现比较直接检查当前玩家的所有棋子是否全部走到对方的对角线区域。具体方法是遍历棋盘数组统计玩家棋子是否还留在初始区域如果某个玩家的所有棋子都离开了初始区域该玩家获胜。源码里通常会有一个类似 CheckWin 的函数在每次移动后调用一次返回 0 表示没有赢家1 或 2 表示对应玩家获胜。如果这个函数的判断条件是“所有棋子都到达对角区域”则还要配合检查目标区域是否已满避免出现双方都认为自己赢了的平局情况。这个状态机的核心价值在于它把所有对局信息收敛在几个变量里UI 层不需要知道规则细节只需要根据当前状态刷新显示。理解了这一点后面看 ttqDlg 与网络模块的交互就轻松了。4. ttqDlg 与 MySocket从本地对战到网络联机的数据流本地对局跑通后这套代码真正值钱的部分是 MySocket——它把跳棋从单人/同屏双人扩展成了网络对战。这一章我会拆开 ttqDlg 的界面控制逻辑再看 MySocket 怎么把棋盘状态变成能在网络上传输的数据包。4.1 对话框即控制器OnPaint 与鼠标消息的路由机制MFC 对话框程序的控制流程完全由消息驱动。ttqDlg 类里你会看到一堆消息映射宏它们把 Windows 的鼠标、键盘、绘制消息路由到对应的成员函数。比如鼠标点击棋盘的操作在 ttqDlg.cpp 里通常对应 ON_WM_LBUTTONDOWN 宏把 WM_LBUTTONDOWN 消息路由到 OnLButtonDown 函数。OnLButtonDown 函数做的事情本质上是把鼠标坐标换算成棋盘行列索引再调用 Tzq 类尝试移动。坐标换算的公式取决于 OnPaint 里绘制棋盘时用的偏移量和格子大小常见做法是记录一个棋盘左上角的像素坐标 (m_nStartX, m_nStartY) 和格子边长 m_nCellSize然后// 鼠标坐标转棋盘行列 void ttqDlg::OnLButtonDown(UINT nFlags, CPoint point) { int row (point.y - m_nStartY) / m_nCellSize; int col (point.x - m_nStartX) / m_nCellSize; // 先检查点击是否落在棋盘有效区域内 if (row 0 || row BOARD_SIZE || col 0 || col BOARD_SIZE) { return; } // 调用游戏逻辑尝试移动返回值表示是否执行成功 if (m_game.Move(row, col, m_nCurrentPlayer)) { // 移动成功重绘棋盘切换玩家检查胜负 Invalidate(FALSE); m_nCurrentPlayer (m_nCurrentPlayer 1) ? 2 : 1; if (m_game.CheckWin() ! 0) { MessageBox(_T(游戏结束), _T(跳棋), MB_OK); } } }这里有个细节容易被忽略m_nStartY 和 m_nCellSize 的取值。如果你是全屏居中绘制这两个值在 OnPaint 里根据窗口客户区大小动态计算但 OnLButtonDown 里也需要访问同样的值如果这两个成员变量在窗口大小变化时没有同步更新就会出现“点击位置和棋子位置对不上”的经典 bug。源码里如果看到 OnSize 函数多半就是在处理这个同步逻辑。OnPaint 函数里除了绘制棋盘格子还要根据资源 ID 加载棋子位图。通常做法是先用 CBitmap 加载资源再通过 BitBlt 或 TransparentBlt 把棋子绘制到对应位置。如果绘制时忘记选回原 Bitmap 对象GDI 对象会持续泄漏程序跑几十步后界面开始卡顿甚至黑屏。4.2 MySocket 的网络对战CSocket 封装、数据包格式与心跳保活MySocket.h 和 MySocket.cpp 是整个工程里最有含金量的部分。它基于 MFC 的 CSocket 类封装了网络通信层让两台机器上的跳棋程序可以互联对战。通信模型并不复杂一方作为服务器监听端口另一方作为客户端连接服务器连接建立后每次落子就把一个数据包发给对方。一个典型的数据包结构可以定义成// 网络数据包结构体用于棋局同步 struct ChessPacket { int nType; // 0连接请求1落子2认输3心跳 int nFromRow; // 起始行 int nFromCol; // 起始列 int nToRow; // 目标行 int nToCol; // 目标列 int nPlayer; // 当前移动的玩家编号 };发送和接收的代码在 MySocket.cpp 里核心是覆盖 CSocket 的 OnReceive 虚函数void MySocket::OnReceive(int nErrorCode) { if (nErrorCode ! 0) { // 网络错误关闭连接并通知上层 AfxMessageBox(_T(网络错误)); Close(); return; } ChessPacket packet; int nRead Receive(packet, sizeof(packet)); if (nRead sizeof(packet)) { // 完整收到一个数据包交给对话框处理 if (m_pDlg) { m_pDlg-OnNetworkPacket(packet); } } // 注意需要再次调用 AsyncSelect 以继续监听 AsyncSelect(FD_READ); }这段代码决定了网络对战的流畅度。Receive 函数的参数传的是 sizeof(packet)如果数据包结构体里有对齐问题比如成员之间被编译器填充了 paddingsizeof 的结果会比实际手算的大收发双方如果打包方式不一致就会导致解析错位。解决办法是显式指定结构体对齐方式或者在网络传输时只发送固定长度的字节数组。心跳包这一层在很多简化版游戏里会被省略但 Socket 连接的稳定性不能只靠 TCP 保活机制。实际应用时我一般会在 ChessPacket 里加一个 nType3 的心跳包由客户端定时发送比如每 3 秒一次服务端收到后回一个同样类型的数据包。如果连续多次没有收到心跳就判定连接已断开。这种机制的实现成本很低但对战时的体验差异巨大——联机跳棋最怕的就是一方掉线了另一方还卡在“等待对方移动”的界面里干等。源码里如果没有心跳逻辑自己加也很方便在 ttqDlg 里加一个定时器每隔几秒调用一次 Send 发送心跳包即可。4.3 同步策略落子即数据包以服务器时钟对齐回合网络对战的同步策略很直接谁落子谁发送数据包对方收到后直接应用到本地棋盘上。不需要像某些实时对战游戏那样做复杂的帧同步因为跳棋是回合制游戏同一时间只有一个玩家有操作权。但这里有一个隐蔽的问题需要处理本地校验和远端校验的一致性。本地玩家点击后程序先在自己这边执行 Tzq 的 Move 函数来判断是否合法合法后才发送数据包。如果本地的规则实现有 bug比如边界判断少了某个方向可能出现“本地认为合法、远端认为非法”的歧义。因此在网络对战中最常见的做法是两端共用同一个 Tzq 类保证规则代码完全一致不要在两端各写一套判断逻辑。// 远端收到落子包后的处理直接应用并重绘 void ttqDlg::OnNetworkPacket(ChessPacket* pPacket) { if (pPacket-nType 1) { // 落子 // 不经过合法性检查直接应用对端已经校验过的移动 m_game.ApplyMove(pPacket-nFromRow, pPacket-nFromCol, pPacket-nToRow, pPacket-nToCol); Invalidate(FALSE); m_nCurrentPlayer (pPacket-nPlayer 1) ? 2 : 1; if (m_game.CheckWin() ! 0) { MessageBox(_T(对方获胜), _T(跳棋), MB_OK); } } }这套策略的优点是逻辑简单几乎没有同步开销缺点是它信任网络包里的数据没有做二次校验。如果你要在公开网络上跑这套程序加一层简单的防作弊校验也容易在数据包里带上当前棋盘状态的哈希值接收方计算本地哈希进行比对不一致就判定数据异常。不过作为学习用途现在的这套设计已经足以让你理解回合制网络游戏的基本通信模型了。5. 避坑手册把老工程跑起来必踩的四个典型翻车点这套代码放在 VC6 时代是开箱即用的但放到今天的系统上各种环境差异会让编译和运行充满意外。下面这些坑是我反复遇到过的每条都按现象、原因、解决的顺序给你捋清楚。5.1 编译报错 fatal error C1010预编译头没配对现象编译某个 .cpp 文件时报 fatal error C1010: unexpected end of file while looking for precompiled header directive后面还带着“Did you forget to add #include StdAfx.h to your source?”的提示。报错文件可能是 Tzq.cpp 或 MySocket.cpp而且看起来代码本身没有任何语法问题。原因这个工程开启了预编译头Precompiled Header选项编译器要求每个 .cpp 文件的第一行必须是 #include StdAfx.h但老工程里个别文件移植时被改动过或者你手工添加了新的 .cpp 文件而忘了加这一行。另外一种可能是某个文件用 #include stdafx.h小写和 StdAfx.h 的实际文件名大小写不一致在大小写不敏感的文件系统上能过在严格区分大小写的环境上就会报错。解决在文件最顶部加上 #include StdAfx.h并确保所有 .cpp 文件都包含这一行。如果是你自己新建的 .cpp 文件最好在项目属性里把预编译头选项设为“不使用”或者统一规范所有文件的头文件引用。改完后 Clean 再重新 Build避免旧的预编译缓存干扰判断。5.2 CSocket 用不了程序直接崩溃或报断言错误现象程序一运行到创建 MySocket 对象的地方就弹出 Debug Assertion Failed或者编译能过但运行时 AfxSocketInit 返回 FALSE网络功能完全用不了。有些人会以为是代码逻辑问题排查半天发现 socket 相关的类根本没有初始化。原因MFC 的 CSocket 类在使用前必须手动调用 AfxSocketInit 进行 Socket 环境初始化这个函数通常放在 InitInstance 里确保 FC 应用程序的进程中已经加载了 Winsock 库。VC6 的工程向导生成的项目会自动带上这段代码但如果你是从旧工程迁移过来的InitInstance 代码可能不完整或者这段代码被条件编译宏包裹住了比如 #ifdef _AFXDLL在静态链接 MFC 时不会执行。解决在 CMyApp::InitInstance 中加入 AfxSocketInit() 调用并检查返回值if (!AfxSocketInit()) { AfxMessageBox(_T(Socket 初始化失败)); return FALSE; }5.3 中文乱码或按钮文字显示问号现象编译运行后对话框上的中文按钮标题、菜单项显示成乱码或者在较新系统上显示为一串问号。棋盘、棋子都能正常显示只有文字是坏的。原因VC6 时代默认使用的是多字节字符集MBCS字符串字面量在源码中以本地代码页通常 GBK/GB2312编码保存。新版 Visual Studio 默认使用 Unicode 字符集你在迁移项目时如果选择了 Unicode 编译选项这些多字节字符串就会在运行时被错误解释导致乱码。另外如果源码文件本身是从老旧系统中拷贝出来文件编码是 ANSI直接在新系统中用 ANSI 模式读取也可能出现字节错位。解决优先尝试在项目属性 → 常规 → 字符集中选择“使用多字节字符集”这是最快的方式。如果你坚持用 Unicode就需要把所有 CString 相关的操作和字符串字面量改造为 _T() 宏包裹同时把文件另存为 UTF-8 with BOM。对于老工程我的建议是不要折腾直接用多字节字符集代码改动最小风险也最低。5.4 点击棋盘没反应消息映射没接上或坐标换算对不上现象程序能启动棋盘也画出来了但用鼠标点击任何位置都没有落子反应或者在棋盘边缘点击时棋子出现的位置和你点的地方差了半个格子的距离。点击没反应还好排查如果是位置偏移往往要找半天。原因点击没反应可能是消息映射宏没写好OnLButtonDown 函数根本没被调用位置偏移则多半是 m_nStartX / m_nStartY 的取值和 OnPaint 里绘画时用的坐标不一致。我遇到过一种情况OnPaint 里根据 GetClientRect 计算了居中的棋盘起点但 OnLButtonDown 里用的是固定写死的坐标值窗口大小一调整两边就错位了。解决在 OnLButtonDown 的第一行加一个调试断点或 AfxMessageBox 输出确认函数是否被调用。如果函数没有被调用检查消息映射宏是否写成了 ON_WM_LBUTTONDOWN()而不是 ON_MESSAGE(WM_LBUTTONDOWN, ...)。两者都能编译但行为完全不同。坐标偏移的话把棋盘起点和格子尺寸抽象成成员变量只在 OnSize 或初始化时计算一次OnPaint 和 OnLButtonDown 都从同一个变量读取。还有一个容易忽略的是资源文件的问题。ttq.rc 里定义的位图 ID 如果和 resource.h 里的定义不一致或者在资源编辑器里误改了位图尺寸绘制时画面会花。排查方法是在 OnPaint 里单独加载一张位图测试排除是绘制逻辑还是资源的问题。6. 进阶玩法加入 AI、录像回放与网络对战的压测技巧这套工程跑通之后如果你不满足于双人对战可以做三件有价值的事。第一是给程序加一个简单的 AI 对手第二是实现棋局录像回放第三是对网络模块做一轮健壮性压测。AI 的实现并不复杂。跳棋的局面评估可以简化成“己方棋子到目标区域的平均距离”距离越短越好。在 Tzq 类的派生类或新增的 AiPlayer 类里用贪心策略找到一步或两步跳中评分最高的移动即可。如果你想要更强的 AI可以在此基础上实现一个带深度限制的 Minimax 搜索叶子节点的评分就用上述距离函数。Alpha-Beta 剪枝在这个棋盘规模下并不需要很深搜索深度到 3 就已经有不错的表现5 以上效果提升就很有限了。可以设计成搜索深度和单步移动的枚举顺序都做成可配置的参数这样学习和调优都方便。录像回放是一个非常好的工程练习。每次移动前记录棋子的起始行列和目标行列追加到一个链表中回放时按顺序重新执行这些移动同时每一步之间加一个定时器延时比如 500 毫秒。实现的关键是要保证录像数据和应用逻辑完全隔离不要直接记录棋盘状态快照而是记录第 n 步谁从哪到哪这样回放代码和正常对局共用同一个移动入口bug 天然会少很多。验证录像是否正确的唯一标准就是回放结果和实际对局结果完全一致——这个测试逻辑几乎不用额外写我对录好的文件逐帧查看时会重点检查连跳的那几步有没有被中间态误导。最后一个建议是把网络对战拿到真实网络环境中压测。在局域网里用两台电脑对战分别扮演服务器和客户端连续对战 30 分钟以上重点观察三个指标棋局过程中有没有卡顿、掉线后能不能检测到、恢复网络后程序是否还能继续操作。你会发现CSocket 的 Receive 调用在某些边界条件下可能一次只收到半个包如果代码里没有做粘包和半包处理就会出现数据错乱。解决的办法是维护一个接收缓冲区对数据包长度做合法性验证不足一个完整包时继续等待。我从改这份代码的经历里学到的最大教训是只改规则但不动接口然后想当然地验证是最大的坑。从那以后我每次改完 Tzq 里的移动判断都会强制走一遍同一套用例——红方直跳、蓝方连跳、边界出界、隔己方子跳过失败每一条都要过不跑一遍就不算改完。这套代码不是看完就完的希望帮到你以后也能变成你自己案头能随时拿出来用的底子。本文还有配套的精品资源点击获取