简介这是一份面向C初学者与进阶开发者的中国象棋游戏完整源代码适合用于课程设计、毕业项目参考或面向对象编程的实战练习。项目以C类与对象为核心将将、士、象、马、车、炮、兵等棋子抽象为独立类通过继承与多态实现各自的移动与吃子规则并借助二维数组表示棋盘、配合合法性检查与走子算法完成对局逻辑同时涉及控制台或第三方库的界面交互与输入处理。资源包共76个文件以18个h头文件、17个cpp源文件为主体另含20个ico图标、4个set配置、3个txt说明及dsw、dsp等工程文件整体约334KB结构完整可直接编译研究。目前已有1532人学习下载读者可从中掌握类设计、数据结构、算法校验与工程组织思路是理解复杂游戏系统实现方式的实用素材。1. 拿到一份 C 中国象棋源代码先别急着双击运行很多人第一次接触 C 中国象棋游戏源代码是在某个资源站下载到一个 7z 压缩包解压后看到一堆 .cpp、.h 和几个资源文件然后卡在第一步这东西到底怎么跑起来它值不值得我花时间读我拿它练手能学到什么这份代码的价值不在“能下棋”而在它把 C 面向对象、STL 容器、搜索算法、图形绘制这几块知识揉进了一个完整可运行的项目里。你打开它能看到棋盘怎么用二维数组表示、走法怎么生成、AI 怎么用极小化极大搜索配合 Alpha-Beta 剪枝选步、界面怎么用 EasyX 或 Qt 画出来。适合两类人一是刚学完 C 语法想找个中型项目练手的二是想理解棋类 AI 搜索框架的。不适合指望直接拿去做商业产品的——这类代码通常界面粗糙、AI 棋力有限但作为学习骨架非常够用。2. 把 7z 里的工程跑起来环境、编译与第一次落子2.1 先判断它用的是哪套图形库解压后第一件事不是打开 main.cpp而是看工程里引了哪些头文件。C 中国象棋源代码常见的图形方案有三种EasyXWindows 下最简单#include graphics.h、Qt有 .pro 或 CMakeLists.txt头文件带QWidget、以及纯控制台只有iostream和conio.h。判断方法很直接# 在解压目录下搜索关键头文件引用 grep -r graphics.h . --include*.cpp --include*.h grep -r QApplication . --include*.cpp grep -r conio.h . --include*.cpp如果命中graphics.h说明是 EasyX 方案你需要在 Visual Studio 里装 EasyX 库命中QApplication则是 Qt 工程用 Qt Creator 打开 .pro 文件即可只有conio.h和iostream就是控制台版任何编译器都能编。提示EasyX 只支持 Visual Studio 的 MSVC 编译器用 MinGW 或 VS Code 配 g 会报链接错误这不是代码问题是库不兼容。2.2 用 VS Code 配置 C/C 环境编译控制台版如果代码是控制台版本用 VS Code 也能跑。先确认装了 MinGW-w64然后建三个配置文件。tasks.json负责编译{ version: 2.0.0, tasks: [ { label: build chess, type: shell, command: g, args: [ -g, -stdc17, *.cpp, // 把所有源文件一起编译 -o, chess.exe ], group: { kind: build, isDefault: true } } ] }launch.json负责调试启动{ version: 0.2.0, configurations: [ { name: run chess, type: cppdbg, request: launch, program: ${workspaceFolder}/chess.exe, preLaunchTask: build chess, console: externalTerminal } ] }参数说明-stdc17是因为不少棋类代码用了auto和结构化绑定*.cpp通配符要求所有源文件在同一目录如果代码分了 src 子目录要改成src/*.cppconsole设成externalTerminal是因为控制台版象棋需要键盘输入VS Code 内置终端对getch()支持不稳定。编译通过后运行你会看到棋盘用字符画出来比如车马象士将士象马车这种。输入坐标走子如果程序没崩、能轮换走棋说明工程完整。2.3 用 CMake 统一管理多文件工程如果解压出来有十几个 .cpp手动敲 g 容易漏文件。写一个 CMakeLists.txt 更省事cmake_minimum_required(VERSION 3.10) project(ChineseChess CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 自动收集当前目录下所有源文件 file(GLOB SOURCES *.cpp) add_executable(chess ${SOURCES}) # 如果是 EasyX 方案取消下面注释并改成你的库路径 # target_include_directories(chess PRIVATE C:/EasyX/include) # target_link_libraries(chess C:/EasyX/lib/EasyXa.lib)然后mkdir build cd build cmake .. cmake --build .就能出可执行文件。file(GLOB ...)的坑是新增文件后不会自动重新扫描需要手动重新跑 cmake所以正式项目里更推荐显式列出源文件。3. 读懂棋盘数据结构二维数组、STL 与走法生成3.1 棋盘为什么用 10×9 的二维数组中国象棋棋盘是 10 行 9 列绝大多数源代码用int board[10][9]表示。正值代表红方负值代表黑方绝对值代表兵种// 常见的棋子编码方式 const int EMPTY 0; const int KING 1; // 将/帅 const int ADVISOR 2; // 士/仕 const int BISHOP 3; // 象/相 const int KNIGHT 4; // 马 const int ROOK 5; // 车 const int CANNON 6; // 炮 const int PAWN 7; // 兵/卒 int board[10][9]; // board[row][col]row 0 是黑方底线用正负号区分阵营的好处是走法判断可以统一处理红方车走法规则和黑方车完全一样只是方向相反。判断某个位置是不是己方棋子只需要看board[r][c]的符号和当前走子方是否一致。注意有些代码用board[9][10]即列在前读代码时先确认索引顺序否则走法生成会整体错位表现为棋子能走但走到奇怪的位置。3.2 走法生成的核心循环走法生成是象棋引擎的心脏。以车为例从当前位置向四个方向延伸遇到空位就加入走法列表遇到己方棋子停止遇到对方棋子加入后停止// 生成车的所有合法走法 void genRookMoves(int r, int c, int side, std::vectorMove moves) { // 四个方向上下左右 int dr[4] {-1, 1, 0, 0}; int dc[4] {0, 0, -1, 1}; for (int d 0; d 4; d) { int nr r dr[d]; int nc c dc[d]; // 一路延伸直到出界 while (nr 0 nr 10 nc 0 nc 9) { if (board[nr][nc] EMPTY) { moves.push_back({r, c, nr, nc}); // 空位可走 } else { // 遇到棋子对方棋子可吃然后停止 if (board[nr][nc] * side 0) { moves.push_back({r, c, nr, nc}); } break; // 无论敌友都停止延伸 } nr dr[d]; nc dc[d]; } } }逻辑说明side传 1 表示红方、-1 表示黑方board[nr][nc] * side 0就是“目标格棋子与当前方异号”即对方棋子。break的位置很关键——遇到任何棋子都要停止只有对方棋子才额外加入走法。参数moves用引用传递避免拷贝这是性能敏感代码里的常见写法。马和象的走法要额外判断“蹩马腿”和“塞象眼”炮的走法要处理“隔一个棋子吃子”的逻辑这些在源代码里通常各占一个函数读的时候按兵种逐个对照规则验证。3.3 用 STL 容器管理走法列表和局面历史走法列表用std::vectorMove是最自然的选型因为搜索过程中需要频繁增删。局面历史用std::stack或std::vector保存用于悔棋功能struct Move { int fromR, fromC; // 起点 int toR, toC; // 终点 int captured; // 被吃掉的棋子用于悔棋恢复 }; std::vectorMove history; // 走子历史悔棋时 pop_backcaptured字段是悔棋的关键——撤销一步棋时要把被吃的棋子放回原位。如果源代码没存这个字段悔棋功能就会丢子这是很多初学者改代码时踩的坑。4. AI 搜索与剪枝让电脑走出像样的棋4.1 极小化极大搜索的基本框架象棋 AI 的核心是博弈树搜索。假设轮到红方走红方要选一个让局面评分最高的走法然后黑方要选一个让评分最低的走法因为评分是从红方视角算的。这就是极小化极大// 从当前方视角搜索depth 是剩余搜索深度 int minimax(int depth, int side) { if (depth 0) return evaluate(); // 到达叶子返回局面评分 std::vectorMove moves; generateAllMoves(side, moves); if (side RED) { // 红方取最大 int best -INF; for (auto m : moves) { makeMove(m); best std::max(best, minimax(depth - 1, -side)); undoMove(m); } return best; } else { // 黑方取最小 int best INF; for (auto m : moves) { makeMove(m); best std::min(best, minimax(depth - 1, -side)); undoMove(m); } return best; } }makeMove和undoMove必须严格配对任何一条路径上漏掉 undo 都会污染后续搜索。evaluate()是局面评估函数通常给每个棋子一个基础分值车 900、马 400、炮 450、兵 100 之类再加上位置加成。4.2 Alpha-Beta 剪枝把搜索量砍掉一大半纯极小化极大在深度 4 以上就慢得没法用。Alpha-Beta 剪枝的原理是如果已经找到一个走法能保证至少 alpha 分而另一条分支最多只能给 beta 分且 beta alpha那这条分支就不用看了。int alphaBeta(int depth, int side, int alpha, int beta) { if (depth 0) return evaluate(); std::vectorMove moves; generateAllMoves(side, moves); // 走法排序吃子优先提高剪枝效率 std::sort(moves.begin(), moves.end(), [](const Move a, const Move b) { return std::abs(board[a.toR][a.toC]) std::abs(board[b.toR][b.toC]); }); if (side RED) { int best -INF; for (auto m : moves) { makeMove(m); best std::max(best, alphaBeta(depth - 1, -side, alpha, beta)); undoMove(m); alpha std::max(alpha, best); if (beta alpha) break; // 剪枝 } return best; } else { int best INF; for (auto m : moves) { makeMove(m); best std::min(best, alphaBeta(depth - 1, -side, alpha, beta)); undoMove(m); beta std::min(beta, best); if (beta alpha) break; // 剪枝 } return best; } }参数说明alpha是当前方已经能保证的最低分beta是对方能保证的最高分。初始调用传alphaBeta(4, RED, -INF, INF)。走法排序那行是血泪经验——不排序的话剪枝效果可能只有 30%排好序能到 70% 以上。吃子走法优先是因为它们最容易引发剪枝。4.3 评估函数怎么调才不“送子”评估函数直接决定 AI 棋力。最简单的版本只算子力总和但这样 AI 会用马换炮、用车换马因为它不知道位置价值。常见做法是加位置分表// 兵的位置加成表红方视角row 0 是黑方底线 int pawnPos[10][9] { { 0, 0, 0, 0, 0, 0, 0, 0, 0}, { 0, 0, 0, 0, 0, 0, 0, 0, 0}, { 0, 0, 0, 0, 0, 0, 0, 0, 0}, { 0, 0, 0, 0, 0, 0, 0, 0, 0}, { 0, 0, 0, 0, 0, 0, 0, 0, 0}, { 0, 0, 0, 0, 0, 0, 0, 0, 0}, {10, 10, 10, 20, 30, 20, 10, 10, 10}, // 过河兵加分 {20, 30, 50, 80, 100, 80, 50, 30, 20}, // 深入敌阵加分 {20, 30, 50, 80, 100, 80, 50, 30, 20}, { 0, 0, 0, 0, 0, 0, 0, 0, 0} };评估时把每个棋子的基础分加上对应位置分。红方兵在 row 7 的中间列能加 100 分相当于一个车的十分之一这样 AI 就愿意把兵往前拱。黑方的表要上下翻转。提示位置分表不要凭感觉写可以先用简单规则跑几盘看 AI 是不是老把兵留在原地不动再针对性调高过河兵的分值。5. 编译运行中的避坑与排查5.1 现象编译报错 “undefined reference toinitgraph”原因EasyX 库没有正确链接。EasyX 不是标准库需要单独安装并在项目属性里配置库目录和附加依赖项。解决在 Visual Studio 里右键项目 → 属性 → VC 目录 → 库目录加入 EasyX 的 lib 路径然后在链接器 → 输入 → 附加依赖项里加上EasyXa.libDebug或EasyXw.libRelease。用 VS Code MinGW 的话EasyX 根本不支持只能换控制台版或改用 Qt。5.2 现象程序运行后棋盘画出来了但点击没反应原因消息循环或输入处理写错了。EasyX 方案常见的是getmessage和peekmessage混用导致事件被吞控制台版常见的是getch()读到了回车符而不是方向键。解决EasyX 里统一用ExMessage msg; while (peekmessage(msg)) { ... }处理鼠标点击不要同时用getmessage。控制台版方向键是两字节编码第一个字节是 0 或 224需要连续读两次int ch getch(); if (ch 0 || ch 224) { ch getch(); // 读第二个字节才是真正的键码 }5.3 现象AI 思考时间越来越长最后卡死原因搜索深度设太大或者没有正确剪枝。深度每加 1节点数大约乘 5 到 10深度 6 以上在普通电脑上可能要几十秒。解决把默认搜索深度降到 3 或 4同时确认 Alpha-Beta 剪枝的break确实生效了。可以在剪枝那行加个计数器打印剪枝次数如果为 0 说明 alpha/beta 更新逻辑写反了。5.4 现象悔棋后棋子位置对了但被吃的子没回来原因Move结构体里没存captured字段或者undoMove里忘了恢复。解决在makeMove里先把目标格棋子存到Move::capturedundoMove里把board[toR][toC]设回captured再把board[fromR][fromC]设回移动的棋子。顺序不能反否则会覆盖。5.5 现象换台电脑编译报 “fopen 不安全”原因MSVC 默认把fopen标记为不安全要求用fopen_s。这是编译器安全警告升级成错误。解决在文件开头加#define _CRT_SECURE_NO_WARNINGS或者在项目属性 → C/C → 预处理器 → 预处理器定义里加上这个宏。不要真的去改代码用fopen_s因为fopen_s参数不同改一处会牵连很多地方。6. 从能跑到好用给象棋源代码加一个“悔棋 提示”组合键把工程跑起来只是起点。真正让这份代码变成你自己的东西是加一个实用功能。我一般会先加“悔棋 提示”组合键因为它同时练到历史栈管理和搜索复用。悔棋的逻辑是维护一个std::vectorMove history每走一步 push按 U 键时 pop 最后一步并调用undoMove。提示的逻辑是复用 AI 的搜索函数但只返回最佳走法而不执行// 提示搜索当前方最佳走法高亮显示 Move getHint(int side, int depth) { std::vectorMove moves; generateAllMoves(side, moves); int bestScore (side RED) ? -INF : INF; Move bestMove moves[0]; for (auto m : moves) { makeMove(m); int score alphaBeta(depth - 1, -side, -INF, INF); undoMove(m); if (side RED score bestScore) { bestScore score; bestMove m; } else if (side BLACK score bestScore) { bestScore score; bestMove m; } } return bestMove; }参数说明depth建议设成 AI 正常搜索深度减 1否则提示和 AI 走法完全一样失去参考意义。返回的bestMove用不同颜色在棋盘上画个圈EasyX 里用setlinecolor加circle控制台版用SetConsoleTextAttribute改背景色。验证方法很直接走几步后按提示看它建议的走法是不是明显比随机走子合理按悔棋看棋盘和步数是否回到上一步。如果提示总是建议送子说明评估函数的位置分表需要调如果悔棋后 AI 搜索崩溃检查history和棋盘状态是否同步。我自己的习惯是每改一个功能就用git commit存一次因为棋类代码的状态耦合很紧改坏一处很难回滚。另外搜索深度不要贪心设太高深度 4 配合好的评估函数已经能下得像模像样深度 6 带来的提升远不如把评估函数调准。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/7 20:53:49 · 阅读 1.2k C++中国象棋源代码解析：从编译运行到AI搜索与悔棋实现
简介这是一份面向C初学者与进阶开发者的中国象棋游戏完整源代码适合用于课程设计、毕业项目参考或面向对象编程的实战练习。项目以C类与对象为核心将将、士、象、马、车、炮、兵等棋子抽象为独立类通过继承与多态实现各自的移动与吃子规则并借助二维数组表示棋盘、配合合法性检查与走子算法完成对局逻辑同时涉及控制台或第三方库的界面交互与输入处理。资源包共76个文件以18个h头文件、17个cpp源文件为主体另含20个ico图标、4个set配置、3个txt说明及dsw、dsp等工程文件整体约334KB结构完整可直接编译研究。目前已有1532人学习下载读者可从中掌握类设计、数据结构、算法校验与工程组织思路是理解复杂游戏系统实现方式的实用素材。1. 拿到一份 C 中国象棋源代码先别急着双击运行很多人第一次接触 C 中国象棋游戏源代码是在某个资源站下载到一个 7z 压缩包解压后看到一堆 .cpp、.h 和几个资源文件然后卡在第一步这东西到底怎么跑起来它值不值得我花时间读我拿它练手能学到什么这份代码的价值不在“能下棋”而在它把 C 面向对象、STL 容器、搜索算法、图形绘制这几块知识揉进了一个完整可运行的项目里。你打开它能看到棋盘怎么用二维数组表示、走法怎么生成、AI 怎么用极小化极大搜索配合 Alpha-Beta 剪枝选步、界面怎么用 EasyX 或 Qt 画出来。适合两类人一是刚学完 C 语法想找个中型项目练手的二是想理解棋类 AI 搜索框架的。不适合指望直接拿去做商业产品的——这类代码通常界面粗糙、AI 棋力有限但作为学习骨架非常够用。2. 把 7z 里的工程跑起来环境、编译与第一次落子2.1 先判断它用的是哪套图形库解压后第一件事不是打开 main.cpp而是看工程里引了哪些头文件。C 中国象棋源代码常见的图形方案有三种EasyXWindows 下最简单#include graphics.h、Qt有 .pro 或 CMakeLists.txt头文件带QWidget、以及纯控制台只有iostream和conio.h。判断方法很直接# 在解压目录下搜索关键头文件引用 grep -r graphics.h . --include*.cpp --include*.h grep -r QApplication . --include*.cpp grep -r conio.h . --include*.cpp如果命中graphics.h说明是 EasyX 方案你需要在 Visual Studio 里装 EasyX 库命中QApplication则是 Qt 工程用 Qt Creator 打开 .pro 文件即可只有conio.h和iostream就是控制台版任何编译器都能编。提示EasyX 只支持 Visual Studio 的 MSVC 编译器用 MinGW 或 VS Code 配 g 会报链接错误这不是代码问题是库不兼容。2.2 用 VS Code 配置 C/C 环境编译控制台版如果代码是控制台版本用 VS Code 也能跑。先确认装了 MinGW-w64然后建三个配置文件。tasks.json负责编译{ version: 2.0.0, tasks: [ { label: build chess, type: shell, command: g, args: [ -g, -stdc17, *.cpp, // 把所有源文件一起编译 -o, chess.exe ], group: { kind: build, isDefault: true } } ] }launch.json负责调试启动{ version: 0.2.0, configurations: [ { name: run chess, type: cppdbg, request: launch, program: ${workspaceFolder}/chess.exe, preLaunchTask: build chess, console: externalTerminal } ] }参数说明-stdc17是因为不少棋类代码用了auto和结构化绑定*.cpp通配符要求所有源文件在同一目录如果代码分了 src 子目录要改成src/*.cppconsole设成externalTerminal是因为控制台版象棋需要键盘输入VS Code 内置终端对getch()支持不稳定。编译通过后运行你会看到棋盘用字符画出来比如车马象士将士象马车这种。输入坐标走子如果程序没崩、能轮换走棋说明工程完整。2.3 用 CMake 统一管理多文件工程如果解压出来有十几个 .cpp手动敲 g 容易漏文件。写一个 CMakeLists.txt 更省事cmake_minimum_required(VERSION 3.10) project(ChineseChess CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 自动收集当前目录下所有源文件 file(GLOB SOURCES *.cpp) add_executable(chess ${SOURCES}) # 如果是 EasyX 方案取消下面注释并改成你的库路径 # target_include_directories(chess PRIVATE C:/EasyX/include) # target_link_libraries(chess C:/EasyX/lib/EasyXa.lib)然后mkdir build cd build cmake .. cmake --build .就能出可执行文件。file(GLOB ...)的坑是新增文件后不会自动重新扫描需要手动重新跑 cmake所以正式项目里更推荐显式列出源文件。3. 读懂棋盘数据结构二维数组、STL 与走法生成3.1 棋盘为什么用 10×9 的二维数组中国象棋棋盘是 10 行 9 列绝大多数源代码用int board[10][9]表示。正值代表红方负值代表黑方绝对值代表兵种// 常见的棋子编码方式 const int EMPTY 0; const int KING 1; // 将/帅 const int ADVISOR 2; // 士/仕 const int BISHOP 3; // 象/相 const int KNIGHT 4; // 马 const int ROOK 5; // 车 const int CANNON 6; // 炮 const int PAWN 7; // 兵/卒 int board[10][9]; // board[row][col]row 0 是黑方底线用正负号区分阵营的好处是走法判断可以统一处理红方车走法规则和黑方车完全一样只是方向相反。判断某个位置是不是己方棋子只需要看board[r][c]的符号和当前走子方是否一致。注意有些代码用board[9][10]即列在前读代码时先确认索引顺序否则走法生成会整体错位表现为棋子能走但走到奇怪的位置。3.2 走法生成的核心循环走法生成是象棋引擎的心脏。以车为例从当前位置向四个方向延伸遇到空位就加入走法列表遇到己方棋子停止遇到对方棋子加入后停止// 生成车的所有合法走法 void genRookMoves(int r, int c, int side, std::vectorMove moves) { // 四个方向上下左右 int dr[4] {-1, 1, 0, 0}; int dc[4] {0, 0, -1, 1}; for (int d 0; d 4; d) { int nr r dr[d]; int nc c dc[d]; // 一路延伸直到出界 while (nr 0 nr 10 nc 0 nc 9) { if (board[nr][nc] EMPTY) { moves.push_back({r, c, nr, nc}); // 空位可走 } else { // 遇到棋子对方棋子可吃然后停止 if (board[nr][nc] * side 0) { moves.push_back({r, c, nr, nc}); } break; // 无论敌友都停止延伸 } nr dr[d]; nc dc[d]; } } }逻辑说明side传 1 表示红方、-1 表示黑方board[nr][nc] * side 0就是“目标格棋子与当前方异号”即对方棋子。break的位置很关键——遇到任何棋子都要停止只有对方棋子才额外加入走法。参数moves用引用传递避免拷贝这是性能敏感代码里的常见写法。马和象的走法要额外判断“蹩马腿”和“塞象眼”炮的走法要处理“隔一个棋子吃子”的逻辑这些在源代码里通常各占一个函数读的时候按兵种逐个对照规则验证。3.3 用 STL 容器管理走法列表和局面历史走法列表用std::vectorMove是最自然的选型因为搜索过程中需要频繁增删。局面历史用std::stack或std::vector保存用于悔棋功能struct Move { int fromR, fromC; // 起点 int toR, toC; // 终点 int captured; // 被吃掉的棋子用于悔棋恢复 }; std::vectorMove history; // 走子历史悔棋时 pop_backcaptured字段是悔棋的关键——撤销一步棋时要把被吃的棋子放回原位。如果源代码没存这个字段悔棋功能就会丢子这是很多初学者改代码时踩的坑。4. AI 搜索与剪枝让电脑走出像样的棋4.1 极小化极大搜索的基本框架象棋 AI 的核心是博弈树搜索。假设轮到红方走红方要选一个让局面评分最高的走法然后黑方要选一个让评分最低的走法因为评分是从红方视角算的。这就是极小化极大// 从当前方视角搜索depth 是剩余搜索深度 int minimax(int depth, int side) { if (depth 0) return evaluate(); // 到达叶子返回局面评分 std::vectorMove moves; generateAllMoves(side, moves); if (side RED) { // 红方取最大 int best -INF; for (auto m : moves) { makeMove(m); best std::max(best, minimax(depth - 1, -side)); undoMove(m); } return best; } else { // 黑方取最小 int best INF; for (auto m : moves) { makeMove(m); best std::min(best, minimax(depth - 1, -side)); undoMove(m); } return best; } }makeMove和undoMove必须严格配对任何一条路径上漏掉 undo 都会污染后续搜索。evaluate()是局面评估函数通常给每个棋子一个基础分值车 900、马 400、炮 450、兵 100 之类再加上位置加成。4.2 Alpha-Beta 剪枝把搜索量砍掉一大半纯极小化极大在深度 4 以上就慢得没法用。Alpha-Beta 剪枝的原理是如果已经找到一个走法能保证至少 alpha 分而另一条分支最多只能给 beta 分且 beta alpha那这条分支就不用看了。int alphaBeta(int depth, int side, int alpha, int beta) { if (depth 0) return evaluate(); std::vectorMove moves; generateAllMoves(side, moves); // 走法排序吃子优先提高剪枝效率 std::sort(moves.begin(), moves.end(), [](const Move a, const Move b) { return std::abs(board[a.toR][a.toC]) std::abs(board[b.toR][b.toC]); }); if (side RED) { int best -INF; for (auto m : moves) { makeMove(m); best std::max(best, alphaBeta(depth - 1, -side, alpha, beta)); undoMove(m); alpha std::max(alpha, best); if (beta alpha) break; // 剪枝 } return best; } else { int best INF; for (auto m : moves) { makeMove(m); best std::min(best, alphaBeta(depth - 1, -side, alpha, beta)); undoMove(m); beta std::min(beta, best); if (beta alpha) break; // 剪枝 } return best; } }参数说明alpha是当前方已经能保证的最低分beta是对方能保证的最高分。初始调用传alphaBeta(4, RED, -INF, INF)。走法排序那行是血泪经验——不排序的话剪枝效果可能只有 30%排好序能到 70% 以上。吃子走法优先是因为它们最容易引发剪枝。4.3 评估函数怎么调才不“送子”评估函数直接决定 AI 棋力。最简单的版本只算子力总和但这样 AI 会用马换炮、用车换马因为它不知道位置价值。常见做法是加位置分表// 兵的位置加成表红方视角row 0 是黑方底线 int pawnPos[10][9] { { 0, 0, 0, 0, 0, 0, 0, 0, 0}, { 0, 0, 0, 0, 0, 0, 0, 0, 0}, { 0, 0, 0, 0, 0, 0, 0, 0, 0}, { 0, 0, 0, 0, 0, 0, 0, 0, 0}, { 0, 0, 0, 0, 0, 0, 0, 0, 0}, { 0, 0, 0, 0, 0, 0, 0, 0, 0}, {10, 10, 10, 20, 30, 20, 10, 10, 10}, // 过河兵加分 {20, 30, 50, 80, 100, 80, 50, 30, 20}, // 深入敌阵加分 {20, 30, 50, 80, 100, 80, 50, 30, 20}, { 0, 0, 0, 0, 0, 0, 0, 0, 0} };评估时把每个棋子的基础分加上对应位置分。红方兵在 row 7 的中间列能加 100 分相当于一个车的十分之一这样 AI 就愿意把兵往前拱。黑方的表要上下翻转。提示位置分表不要凭感觉写可以先用简单规则跑几盘看 AI 是不是老把兵留在原地不动再针对性调高过河兵的分值。5. 编译运行中的避坑与排查5.1 现象编译报错 “undefined reference toinitgraph”原因EasyX 库没有正确链接。EasyX 不是标准库需要单独安装并在项目属性里配置库目录和附加依赖项。解决在 Visual Studio 里右键项目 → 属性 → VC 目录 → 库目录加入 EasyX 的 lib 路径然后在链接器 → 输入 → 附加依赖项里加上EasyXa.libDebug或EasyXw.libRelease。用 VS Code MinGW 的话EasyX 根本不支持只能换控制台版或改用 Qt。5.2 现象程序运行后棋盘画出来了但点击没反应原因消息循环或输入处理写错了。EasyX 方案常见的是getmessage和peekmessage混用导致事件被吞控制台版常见的是getch()读到了回车符而不是方向键。解决EasyX 里统一用ExMessage msg; while (peekmessage(msg)) { ... }处理鼠标点击不要同时用getmessage。控制台版方向键是两字节编码第一个字节是 0 或 224需要连续读两次int ch getch(); if (ch 0 || ch 224) { ch getch(); // 读第二个字节才是真正的键码 }5.3 现象AI 思考时间越来越长最后卡死原因搜索深度设太大或者没有正确剪枝。深度每加 1节点数大约乘 5 到 10深度 6 以上在普通电脑上可能要几十秒。解决把默认搜索深度降到 3 或 4同时确认 Alpha-Beta 剪枝的break确实生效了。可以在剪枝那行加个计数器打印剪枝次数如果为 0 说明 alpha/beta 更新逻辑写反了。5.4 现象悔棋后棋子位置对了但被吃的子没回来原因Move结构体里没存captured字段或者undoMove里忘了恢复。解决在makeMove里先把目标格棋子存到Move::capturedundoMove里把board[toR][toC]设回captured再把board[fromR][fromC]设回移动的棋子。顺序不能反否则会覆盖。5.5 现象换台电脑编译报 “fopen 不安全”原因MSVC 默认把fopen标记为不安全要求用fopen_s。这是编译器安全警告升级成错误。解决在文件开头加#define _CRT_SECURE_NO_WARNINGS或者在项目属性 → C/C → 预处理器 → 预处理器定义里加上这个宏。不要真的去改代码用fopen_s因为fopen_s参数不同改一处会牵连很多地方。6. 从能跑到好用给象棋源代码加一个“悔棋 提示”组合键把工程跑起来只是起点。真正让这份代码变成你自己的东西是加一个实用功能。我一般会先加“悔棋 提示”组合键因为它同时练到历史栈管理和搜索复用。悔棋的逻辑是维护一个std::vectorMove history每走一步 push按 U 键时 pop 最后一步并调用undoMove。提示的逻辑是复用 AI 的搜索函数但只返回最佳走法而不执行// 提示搜索当前方最佳走法高亮显示 Move getHint(int side, int depth) { std::vectorMove moves; generateAllMoves(side, moves); int bestScore (side RED) ? -INF : INF; Move bestMove moves[0]; for (auto m : moves) { makeMove(m); int score alphaBeta(depth - 1, -side, -INF, INF); undoMove(m); if (side RED score bestScore) { bestScore score; bestMove m; } else if (side BLACK score bestScore) { bestScore score; bestMove m; } } return bestMove; }参数说明depth建议设成 AI 正常搜索深度减 1否则提示和 AI 走法完全一样失去参考意义。返回的bestMove用不同颜色在棋盘上画个圈EasyX 里用setlinecolor加circle控制台版用SetConsoleTextAttribute改背景色。验证方法很直接走几步后按提示看它建议的走法是不是明显比随机走子合理按悔棋看棋盘和步数是否回到上一步。如果提示总是建议送子说明评估函数的位置分表需要调如果悔棋后 AI 搜索崩溃检查history和棋盘状态是否同步。我自己的习惯是每改一个功能就用git commit存一次因为棋类代码的状态耦合很紧改坏一处很难回滚。另外搜索深度不要贪心设太高深度 4 配合好的评估函数已经能下得像模像样深度 6 带来的提升远不如把评估函数调准。希望帮到你。本文还有配套的精品资源点击获取