简介基于QT与C实现的德州扑克游戏项目是面向计算机、通信、人工智能、自动化等相关专业学生及从业者的毕业设计源码包适合用于课程设计、大作业或论文答辩前的完整参考。资源内含97个文件、约9.62MB其中包含9个C源文件、8个头文件、Qt的ui界面文件及丰富的PNG运行截图另有DOC项目文档目录结构清晰源码与文档可对照学习。目前已有138人学习浏览。项目为作者亲历的毕设答辩评审分98分代码经调试测试可运行除了德州扑克的完整对战逻辑、AI打牌流程、发牌与下注机制外附带的详细文档还说明了模块划分与关键实现便于初学者理解Qt的事件驱动和C面向对象设计基础较好的读者也能在此基础上扩展新玩法或优化界面。1. 这个毕业设计到底值不值得做从答辩痛点说起每年毕业季都能在实验室里看到这样的场景同学抱着几百页的 Java 管理系统 PPT 讲得口干舌燥老师低头问一句这个系统的并发你是怎么处理的全场安静。但做基于QTC开发的德州扑克游戏的人很少会遭遇这种冷场——因为这个项目天然自带几层楼可问C 的内存管理、QT 的信号槽机制、游戏轮转的状态机设计、牌型判定的算法效率每一个都能往深了聊。而且它是个看得见摸得着的桌面程序演示效果直观界面能截屏放进论文运行过程能录屏放进答辩 PPT比纯后端项目好展示得多。但这里要先泼一盆冷水网上流传的所谓QT德州扑克毕业设计源码很多是拿 Qt4 时代的老代码改的或者干脆是控制台版的扑克牌判型加上一个半成品界面。你要打算照抄大概率会遇到热词搜索里那两个经典报错——fatal: cannot mix incompatible qt library和qt.qpa.plugin: could not find the qt platform plugin linuxfb。前者是 Qt 版本混用后者是 Linux 下缺平台插件这两条坑后面会专门讲。本文不卖源码只把这个项目从架构到落地拆成你能照做的方案类怎么设计、牌型算法怎么写、界面怎么布局、文档怎么组织、答辩时老师问什么一句话一句话给你交代清楚。2. 先把架构立住这个项目应该拆成哪几层2.1 为什么三层架构是毕业设计的安全区德州扑克游戏表面上看是个界面程序但你要是把所有逻辑全塞进 MainWindow写到后面一定会翻车。原因很简单游戏状态太多了。翻牌前、翻牌、转牌、河牌四个阶段每个阶段玩家可以跟注、加注、弃牌、全下底池要累计、玩家筹码要扣除、庄家按钮要轮转。这些逻辑要是跟按钮的点击响应函数搅在一起Debug 的时候你会疯掉——改一个加注的逻辑界面刷新全乱。我一般会把项目拆成三个模块这也是最稳妥的架构答辩话术数据模型层Model负责牌、牌堆、玩家、底池这些纯数据结构不依赖任何 QT 头文件。游戏逻辑层Logic负责洗牌、发牌、下注轮转、牌型判定、胜负结算通过信号槽把状态变化广播出去。界面表现层View只负责把游戏状态画出来把用户的点击翻译成指令发给 Logic。这样做的好处答辩时可以直接说出来数据模型层不依赖 QT意味着你可以写纯 C 的单元测试游戏逻辑层和界面层用信号槽解耦意味着未来把 QWidget 换成 QML 界面或者加个网络对战版本逻辑层不用动。这三句话比你在答辩 PPT 上写十页系统简介都有说服力。2.2 核心类的设计与职责划分先定义一个最底层的Card 类它代表一张牌。花色用枚举点数用整数 2-14 表示11J12Q13K14A这样后面做牌型判断时可以直接比较数值大小。// card.h #ifndef CARD_H #define CARD_H enum class Suit { Spade, // 黑桃 Heart, // 红桃 Club, // 梅花 Diamond // 方块 }; class Card { public: Card(Suit suit, int rank) : m_suit(suit), m_rank(rank) {} Suit suit() const { return m_suit; } int rank() const { return m_rank; } // 用字符串描述一张牌比如 黑桃A QString toString() const { QString rankStr; switch (m_rank) { case 14: rankStr A; break; case 13: rankStr K; break; case 12: rankStr Q; break; case 11: rankStr J; break; default: rankStr QString::number(m_rank); } QString suitStr; switch (m_suit) { case Suit::Spade: suitStr 黑桃; break; case Suit::Heart: suitStr 红桃; break; case Suit::Club: suitStr 梅花; break; case Suit::Diamond: suitStr 方块; break; } return suitStr rankStr; } private: Suit m_suit; int m_rank; // 2 ~ 14 }; #endif // CARD_H这里的rank()返回 int 而不是直接返回字符串是为了后面排序和比较大小方便。很多新手会在这里存一张 QPixmap把牌面和算法搅在一起这是误区。界面显示的事情交给 View 层去做Model 层的 Card 就该是干干净净的数据。然后是Deck 类负责洗牌和发牌。洗牌算法用 Fisher-Yates也叫 Knuth 洗牌这是教科书级的写法答辩时老师问为什么不用随机排序你就可以解释直接对牌调用 qSort 然后放一个随机比较函数会让部分牌的位置概率不均Fisher-Yates 是理论上均匀的。// deck.cpp Deck::Deck() { m_cards.reserve(52); for (int suit 0; suit 4; suit) { for (int rank 2; rank 14; rank) { m_cards.append(Card(static_castSuit(suit), rank)); } } } void Deck::shuffle() { // Fisher-Yates 洗牌从后往前遍历每次随机取一张与当前位置交换 std::random_device rd; std::mt19937 gen(rd()); for (int i m_cards.size() - 1; i 0; --i) { std::uniform_int_distributionint dist(0, i); int j dist(gen); std::swap(m_cards[i], m_cards[j]); } } Card Deck::dealCard() { Q_ASSERT(!m_cards.isEmpty()); // 发牌前确认牌堆非空调试期帮你抓逻辑漏洞 return m_cards.takeLast(); // 从尾部取牌效率高于 takeFirst }注意dealCard()用了takeLast()而不是takeFirst()因为 QVector 从头部取元素是 O(n) 的要从尾部取。这个细节虽然影响不大但写到文档里就是考虑到性能的体现。Q_ASSERT是调试利器Release 模式下会自动消失不影响线上性能。2.3 信号槽连接表界面和逻辑的桥梁怎么搭Logic 层和 View 层之间通过 QT 的信号槽通信。我们设计一套协议信号触发时机参数含义界面层的响应gameStateChanged(GameState)阶段切换翻牌前 → 翻牌 → 转牌 → 河牌 → 摊牌当前处在哪个阶段更新中央公共牌区显示翻牌文字提示playerActed(int, PlayerAction)某玩家做了一次动作玩家索引、动作类型在日志区输出 玩家2 加注到 100potChanged(int)底池金额变动当前底池总额刷新底池 Label 显示currentPlayerChanged(int)轮到某玩家行动玩家索引高亮当前玩家的座位框启用/禁用操作按钮gameOver(int)一局结束获胜玩家索引弹出结算框显示获胜牌型在 MainWindow 里通过connect()把这些信号和槽函数关联起来槽函数里只做一件事更新界面上对应的控件。千万不要在槽函数里写游戏逻辑比如在onBetButtonClicked()里直接改玩家的筹码值——那会让状态散落一地答辩时老师问你这个筹码数据有几处维护你答不上来。逻辑层的核心是GameEngine 类它内部维护玩家列表、底池、公共牌、当前行动玩家索引并且提供playerAction(int playerIndex, BetAction action, int amount)这个入口。界面按钮被点击后调用这个方法把指令传进去引擎内部处理完再通过信号广播结果。这就是经典的单向数据流UI 事件 → Logic 处理 → 发出信号 → UI 刷新。答辩时画一张这样的数据流图放在论文里老师一眼就知道你懂工程分层这个思路比代码本身更值钱。3. Get 到核心算法牌型判断和下注轮转怎么写才能不出 bug3.1 7 选 5 的最大牌型判定一个函数解决所有情况德州扑克最终要比拼的是 5 张牌。你自己手里 2 张公共牌 5 张要从中选出 5 张组成最大牌型。最容易被新手写错的地方在于不是简单判断当前有哪些牌型特征而是要在 7 张里穷举所有 5 张组合C(7,5) 21 种分别计算牌型等级取最大。有同学图省事统计 7 张里每种点数的出现次数然后直接判是否四条、葫芦——这在大多数场景下是对的但边界情况会出错。经典的坑是两对选哪一对还有葫芦选三张一样加一对、而不是三张一样加另外一对更大的时候。最稳妥、最不容易被答辩老师挑刺的实现方式就是暴力枚举 21 种组合。7 张牌的组合数 C(7,5) 21对现代 CPU 而言这个计算量可以忽略不计。代码结构如下// HandEvaluator.cpp HandRank HandEvaluator::evaluate(const QVectorCard sevenCards) { HandRank best; best.level 0; // 枚举 7 张里选 5 张的所有组合用 5 层循环每层索引递增保证组合不重复 for (int a 0; a 3; a) { for (int b a 1; b 4; b) { for (int c b 1; c 5; c) { for (int d c 1; d 6; d) { for (int e d 1; e 7; e) { QVectorCard five { sevenCards[a], sevenCards[b], sevenCards[c], sevenCards[d], sevenCards[e] }; HandRank cur evaluateFive(five); if (cur best) { best cur; } } } } } } return best; }evaluateFive函数接收恰好 5 张牌分别判断同花、顺子、四条、葫芦、三条、两对、一对等。判断顺序从高级到低级代码里用 level 表示等级同等级再比点数。这里最有技术含量的是顺子判断先按 rank 从大到小排序再检查rank[i] - rank[i1] 1但要注意 A-2-3-4-5 这种特殊顺子A 要按 1 来算。常见做法是排序后额外判断一次5,4,3,2,A的排列是否存在。这个算法的时间复杂度是 O(21 * 排序开销)空间复杂度 O(1)在答辩时你可以主动讲出来。如果导师问有没有更快的方案你可以答用查表法把一副牌的 52 位用位向量表示做成哈希表缓存但毕业设计场景用不到显得你有广度。3.2 下注轮转的状态机拒绝 if 嵌套地狱游戏流程本质上是一个状态机。我见过有同学用一个巨大的 switch 套 if写着写着就把自己绕晕了。这里介绍一个更清晰的方案用枚举 状态转移表。enum class GameState { PreFlop, // 翻牌前每人发2张 Flop, // 翻牌公共牌3张 Turn, // 转牌公共牌第4张 River, // 河牌公共牌第5张 Showdown // 摊牌结算 }; // 状态转移表当前状态 - 下一个状态 GameState nextState(GameState s) { switch (s) { case GameState::PreFlop: return GameState::Flop; case GameState::Flop: return GameState::Turn; case GameState::Turn: return GameState::River; case GameState::River: return GameState::Showdown; default: return GameState::PreFlop; // Showdown 结束后重开一局 } }下注逻辑的关键在于一轮下注何时结束。规则是从庄家Button下家开始行动轮到庄家左边第一位玩家时一轮结束。但还有两个特殊情况有人加注时之前跟过注的玩家需要重新行动有玩家全下时如果只剩一个玩家在行动也要提前结束下注轮。我一般用一个简单的策略来管理每一轮开始时记录当前最大下注额和在本轮中已经行动过的玩家集合。每当有人加注就清空这个集合让所有还未重新行动的玩家再次行动。这个逻辑写成代码其实只有三五十行但却是整个游戏最容易出 bug 的地方也是答辩现场老师最爱问的地方。你要是这块讲清楚了基本就是做透了的信号。// 伪代码一轮下注的推进逻辑 void GameEngine::onPlayerBet(int playerIdx, int betAmount) { int maxBet currentMaxBet(); // 本轮当前最高下注额 if (betAmount maxBet) { m_maxBet betAmount; m_actedPlayers.clear(); // 有人加注清空已行动集合 } m_actedPlayers.insert(playerIdx); int nextIdx (playerIdx 1) % m_players.size(); // 跳过已弃牌玩家和已全下玩家 while (m_players[nextIdx]-isFolded() || m_players[nextIdx]-isAllIn()) { nextIdx (nextIdx 1) % m_players.size(); } // 如果除了一人之外其余都已弃牌或所有人都已行动且下注额相同本轮结束 if (allOtherFolded(nextIdx) || (m_actedPlayers.size() activePlayerCount() allBetsEqual())) { advanceToNextRound(); return; } setCurrentPlayer(nextIdx); }while循环跳过弃牌玩家的这段有必要展开说明如果当前玩家已弃牌你不能直接结束这轮下注而是要继续往下找下一个还在行动的人。有的同学会漏掉这一步结果轮到一个已经弃牌的玩家头上游戏就卡死了。这属于典型的看起来简单、实际跑起来就翻车的细节。3.3 底池分配多人全下的边池怎么算底池分配是德州扑克代码里最容易被忽略的难点。简单情况两个人玩一人全下一人跟注赢家拿走全部底池。但多人局里有人全下筹码少有人跟的多就需要分出主池Main Pot和边池Side Pot。很多网上源码直接不做边池拿回来就是阉割版。毕业设计里你要是把边池做出来属于明显的加分项。做法是按筹码从少到多逐层切分把所有参与该局玩家的本轮下注额收集起来按金额从小到大排序。从最小的下注额开始把所有人的下注额都扣掉这个最小值形成一个池子只有下注达到这个数额的人才有资格赢取这个池子。重复上述过程直到所有人都下注额归零。比如三个玩家分别下注 100、100、50。先切出 50 的层三人各 50 组成主池 150只有下注 50 的玩家参与剩下 50、50、0 再切一层下注 100 的两人各 50 组成边池 100由这两人竞争最终记录每个池子的获胜条件。这个逻辑用代码写起来大概 40 行但写清楚之后你的文档里就可以配一个底池分配流程图答辩时直接画给老师看。这里不贴完整代码了建议你把这个部分作为自己独立完成的代码来看待把每一步池子的金额和合格玩家列表记录到结构体里方便后面的结算阶段遍历。4. 界面搭建把算法穿上一件能看的衣服4.1 布局方案用布局管理器撑起整个牌桌德州扑克的界面布局是有讲究的。常见布局底部是自己的手牌和操作按钮区顶部是三家的玩家信息区中间是公共牌区。我建议用 QHBoxLayout 和 QVBoxLayout 组合尽量不要用绝对坐标 setGeometry——因为不同的屏幕分辨率和窗口拉伸会让绝对坐标的界面乱掉。推荐的控件层级是这样的根布局QVBoxLayout上部分QHBoxLayout里面放三个玩家信息面板QLabel 显示昵称/筹码/状态中部公共牌区用一个 QHBoxLayout 放 5 个 QLabel初始显示牌背图案下部操作区QHBoxLayout 放弃牌跟注加注全下四个按钮 一个 QSpinBox 输入加注额玩家数量做 2-6 人可配置即可。如果做三人模式上面的布局最简单每个玩家一个面板水平排开。如果要支持 6 人环形牌桌那就要用 QGridLayout 定位或者干脆用 QPainter 全自绘——后者工程量不小但视觉效果极佳。我建议毕业设计做 3 人或 4 人版本把精力省下来去完善对局记录和 AI 策略而不是死磕全自绘。4.2 用 QLabel 显示牌面最简单的落地路径显示一张扑克牌最省事的方案是QLabel setStyleSheet给标签设置背景色、边框和圆角中间写牌的文字用颜色区分红黑花色。十行代码搞定一张牌。// Widgets 里更新一张牌的显示 void updateCardLabel(QLabel* label, const Card card, bool faceUp) { if (!faceUp) { label-setText(?); label-setStyleSheet( background-color: #2c3e50; color: white; border: 2px solid #1a252f; border-radius: 8px; font-size: 20px; bold; min-width: 60px; min-height: 85px; ); return; } bool isRed (card.suit() Suit::Heart || card.suit() Suit::Diamond); label-setText(card.toString()); label-setStyleSheet(QString( background-color: white; color: %1; border: 2px solid #bdc3c7; border-radius: 8px; font-size: 18px; bold; min-width: 60px; min-height: 85px; ).arg(isRed ? #c0392b : #2c3e50)); }这里有个值得注意的细节min-width和min-height要在样式表里设置否则标签内容为空时显示不出来。牌背颜色用深蓝灰#2c3e50赢了底池高亮时可以用#27ae60变色边框,这些都是界面上的观感细节截图放进论文里会显得你很认真。比这更高级的做法是用 QPainter 自绘牌面仿照真实扑克的左上角点数和右下角镜像但工程量会翻两三倍我一般是告诉你加分的路径在哪但不盲目推荐毕竟一个毕业设计的核心还是把游戏逻辑做明白。4.3 定时器驱动自动操作家 docker 演示不卡场答辩演示最尴尬的场景你需要给老师展示游戏流程但要等自己操作太慢而且气氛很干。解决方式是在设置里做自动运行模式用 QTimer 定时让 AI 玩家自动做决策。这样你打开程序点一下自动演示四个人就能自己玩起来你只需要在旁边解说每一轮发生什么。// MainWindow 里开启自动演示模式 m_timer new QTimer(this); connect(m_timer, QTimer::timeout, this, MainWindow::onAutoPlayTick); m_timer-start(1200); // 每 1.2 秒自动行动一次 void MainWindow::onAutoPlayTick() { // 如果当前轮到人类玩家跳过或者也自动 if (m_engine-currentPlayerIndex() m_humanIndex) { int decision m_aiDecider-decide(m_engine-gameSnapshot()); m_engine-playerAction(m_humanIndex, decision.action, decision.amount); } refreshUI(); // 从引擎拉取最新状态并刷新界面 }这个onAutoPlayTick里的重点人类玩家也能被 AI 决策器接管这样整个游戏才能跑完整。要是你的 AI 写得不错可以加上AI 每轮决策耗时 1 秒的模拟思考时间演示效果会更好。定时器间隔做成了可配置的,既能加速演示又能让老师看清楚关键步骤。5. 避坑与排查QT 环境和 C 侧的 4 个经典翻车现场5.1 编译报错cannot mix incompatible Qt library版本混用的玄学现象项目在别人的电脑上编译运行正常拿到你的电脑上重新构建一编译就报fatal: cannot mix incompatible Qt library (version 0x50601) with this library。原因这个报错的本质是你链接的 Qt 库和你包含的头文件来自两个不同的 Qt 版本。最常见的诱发方式是电脑上装了 Qt 5.12 又装了 Qt 6.xCMake 或 qmake 找到的头文件是D:\Qt\6.5.0\include而链接库路径却指向了D:\Qt\5.12.12\lib。还有一种是用了 IDE 自带的 Qt 套件但环境变量PATH里被某个软件比如 Anaconda插入了其他版本的 Qt 路径。解决在 Qt Creator 里检查构建套件Kit对应的 Qt 版本是否和编译器匹配在项目文件里用QT core gui widgets依赖的是你用qmake或 CMake 指定的版本。建议先彻底卸载旧的 Qt 版本或者每次开项目前先执行qmake -v确认默认的 qmake 路径是不是你期望的那个。Windows 上尤其要注意PATH环境变量里的 Qt 目录顺序把它排在最后面避免被其他软件的 Qt 抢走。5.2 运行时报Could not find the Qt platform plugin linuxfb现象在 Linux 服务器上写好程序用./poker_game启动终端打印qt.qpa.plugin: could not find the Qt platform plugin linuxfb in 程序直接退出。原因这是缺少 Qt 平台插件。平时的桌面 Linux 用xcb嵌入式或纯命令行环境用linuxfb。如果你的 Qt 安装时没选对应组件或者运行时的QT_QPA_PLATFORM_PLUGIN_PATH没有指向插件目录就会报这个。解决在 Ubuntu 桌面上确认安装了libqt5gui5和libxcb-xinerama0用export QT_QPA_PLATFORMoffscreen可以先让程序跑起来适合截图测试正式演示时确保QT_QPA_PLATFORM_PLUGIN_PATH指向你 Qt 安装目录下的plugins/platforms文件夹。这条坑在你用平板或嵌入式设备跑跨平台音乐管理系统这类项目时也会遇到属于 QT 特有的环境问题建议写进文档的运行环境配置一节。5.3 洗牌算法翻车qSort(deck.begin(), deck.end(), randomCompare)的坑现象洗完之后发现某些牌经常出现在固定位置比如黑桃 A 总在最后几张。原因用随机比较函数做排序破坏了严格弱序strict weak ordering的公理整个排序行为是未定义的。有些 STL 实现甚至会在比较时无限循环让你的程序直接卡死。这种写法在一些旧博客里很常见属于典型的误导。解决用 Fisher-Yates 算法这段代码在上面已经贴出来了。如果不想自己实现C11 起可以用std::shuffle配合std::mt19937效果和 Fisher-Yates 一致。注意srand(time(NULL))rand()的方式在现代 C 里不是一个好选择rand()的随机质量不高而且线程不安全建议用std::random_device和std::mt19937。5.4 牌型判断漏掉A-2-3-4-5顺子现象对手手里拿着 A,2,3,4,5 的牌你的程序给判定成了高牌没有识别出顺子。原因判断顺子的常见写法是先排序再检查相邻两张牌的差值是否为 1比如rank[i] - rank[i1] 1。但 A 的 rank 是 14排序后是 14,5,4,3,2相邻差值依次是 9,1,1,1判定失败。这就是著名的轮子顺边界。解决在排序后的五张牌里额外判断一种情况max 14 min 2 剩余三张是 3,4,5。一个更通用的做法是把 A 同时映射成 1 和 14 两套 rank 值分别判断。类似这种边界问题在牌型判定里还有两个著名场景两对牌型里如果用一对较大值配一对较小值葫芦判定时要先找三条再从剩余里找对子而不是先找对子。5.5 QT 中文字体显示成方块的排查路径现象界面上所有中文都是口口口或者在某些 Linux 发行版上按钮文字完全不可见。原因Qt 的中文支持依赖系统的字体库Windows 一般自带宋体和微软雅黑没问题但 Linux 上如果没装中文字体包或者 Qt 找不到 fontconfig 配置就会显示成方块。另外在main.cpp里如果用了QTextCodec::setCodecForLocale老式写法在 Qt6 里直接编译不过——Qt6 默认 UTF-8不再需要这个调用。解决在main()函数开始处设置应用字体QApplication app(argc, argv); QFont font(Microsoft YaHei, 10); // Windows 上 app.setFont(font);如果在 Linux 上先确认系统有没有中文字体fc-list | grep -i song\|hei没有就安装fonts-wqy-microhei或fonts-noto-cjk。建议不要硬编码字体名而是用QFontDatabase检查系统可用字体后做一次选择这样一个代码包在 Windows 和 Linux 上都能正常显示。6. 收尾的加分动作用对局日志和自动化脚本让项目活起来如果你按前面的结构把代码写完项目和一般同学的毕业设计相比已经足够扎实。但还有两件事能明显拉开差距一是把对局日志写成文件二是用自动化脚本做回归测试。这两件事加起来工作量不超过一个下午但答辩演示效果差别很大。对局日志的做法很朴素在GameEngine里加一个logEvent(QString)信号把每一轮的动作串成文本发出去MainWindow里接住追加到一个QTextEdit里同时对局结束时写进game_log.txt。写这个文件要注意用QFile::append模式否则重开一局就覆盖了上一局的记录。void MainWindow::appendLog(const QString line) { m_logTextEdit-append(line); QFile file(game_log.txt); if (file.open(QIODevice::Append | QIODevice::Text)) { QTextStream out(file); out QDateTime::currentDateTime().toString(yyyy-MM-dd hh:mm:ss) line \n; } }自动回归测试的思路是把GameEngine写成不依赖界面的纯逻辑类然后在tests目录里写一个main.cpp定义几个手工构造的对局场景直接调用引擎的接口断言结果是否符合预期。比如玩家 A 手持皇家同花顺应该判定为赢过玩家 B 的四条多个玩家全下时边池分配总额等于总下注额。void testFlushBeatsStraight() { QVectorCard handA { Card(Suit::Heart, 10), Card(Suit::Heart, 11) }; QVectorCard handB { Card(Suit::Spade, 9), Card(Suit::Spade, 8) }; QVectorCard community { Card(Suit::Heart, 2), Card(Suit::Heart, 7), Card(Suit::Diamond, 14), Card(Suit::Club, 5), Card(Suit::Spade, 3) }; // A: 同花B: 顺子但 A 的同花大于 B 的顺子 } void testSidePotSplit() { // 三人全下的边池分配测试 // 玩家 A 下注 50B 下注 100C 下注 100 // 主池 150三人竞争边池 100B 和 C 竞争 }写完测试用例用命令行./poker_tests直接跑所有测试通过后打印ALL TESTS PASSED。把这行输出截图放进毕设论文的测试章节比任何语言都有说服力。这也是我做了这么多 QT 项目之后留下的习惯——永远不要在答辩前一天手动点按钮演示来证明程序没有 bug把这件事交给自动化脚本。最后说一个我自己的经验把文档的运行环境一节写好会省去大量答疑时间。别只写需要 QT要写清楚QT 5.15 或以上编译器 MSVC2019 或 MinGW 8.1.0CMake 3.16并说明在 Windows 上建议用 Qt Creator 自带的构建套件而不是手动配环境。这一步往往是同学之间互相拷项目时翻车最多的地方也是答辩时老师最容易亲手试探的一步。把这些细节落实到位你的毕业设计就不只是一堆能跑的代码而是一个别人拿到手能复现、能验证、能继续改的完整项目。希望这篇按从架构到排错的路径能帮到你——照着这个思路做你的 QT 德州扑克不仅能过答辩还能让老师认为这是一个真的做完了的项目而不是赶工缝合的演示品。本文还有配套的精品资源点击获取 QT+C++实现德州扑克游戏：架构、算法与避坑指南
简介基于QT与C实现的德州扑克游戏项目是面向计算机、通信、人工智能、自动化等相关专业学生及从业者的毕业设计源码包适合用于课程设计、大作业或论文答辩前的完整参考。资源内含97个文件、约9.62MB其中包含9个C源文件、8个头文件、Qt的ui界面文件及丰富的PNG运行截图另有DOC项目文档目录结构清晰源码与文档可对照学习。目前已有138人学习浏览。项目为作者亲历的毕设答辩评审分98分代码经调试测试可运行除了德州扑克的完整对战逻辑、AI打牌流程、发牌与下注机制外附带的详细文档还说明了模块划分与关键实现便于初学者理解Qt的事件驱动和C面向对象设计基础较好的读者也能在此基础上扩展新玩法或优化界面。1. 这个毕业设计到底值不值得做从答辩痛点说起每年毕业季都能在实验室里看到这样的场景同学抱着几百页的 Java 管理系统 PPT 讲得口干舌燥老师低头问一句这个系统的并发你是怎么处理的全场安静。但做基于QTC开发的德州扑克游戏的人很少会遭遇这种冷场——因为这个项目天然自带几层楼可问C 的内存管理、QT 的信号槽机制、游戏轮转的状态机设计、牌型判定的算法效率每一个都能往深了聊。而且它是个看得见摸得着的桌面程序演示效果直观界面能截屏放进论文运行过程能录屏放进答辩 PPT比纯后端项目好展示得多。但这里要先泼一盆冷水网上流传的所谓QT德州扑克毕业设计源码很多是拿 Qt4 时代的老代码改的或者干脆是控制台版的扑克牌判型加上一个半成品界面。你要打算照抄大概率会遇到热词搜索里那两个经典报错——fatal: cannot mix incompatible qt library和qt.qpa.plugin: could not find the qt platform plugin linuxfb。前者是 Qt 版本混用后者是 Linux 下缺平台插件这两条坑后面会专门讲。本文不卖源码只把这个项目从架构到落地拆成你能照做的方案类怎么设计、牌型算法怎么写、界面怎么布局、文档怎么组织、答辩时老师问什么一句话一句话给你交代清楚。2. 先把架构立住这个项目应该拆成哪几层2.1 为什么三层架构是毕业设计的安全区德州扑克游戏表面上看是个界面程序但你要是把所有逻辑全塞进 MainWindow写到后面一定会翻车。原因很简单游戏状态太多了。翻牌前、翻牌、转牌、河牌四个阶段每个阶段玩家可以跟注、加注、弃牌、全下底池要累计、玩家筹码要扣除、庄家按钮要轮转。这些逻辑要是跟按钮的点击响应函数搅在一起Debug 的时候你会疯掉——改一个加注的逻辑界面刷新全乱。我一般会把项目拆成三个模块这也是最稳妥的架构答辩话术数据模型层Model负责牌、牌堆、玩家、底池这些纯数据结构不依赖任何 QT 头文件。游戏逻辑层Logic负责洗牌、发牌、下注轮转、牌型判定、胜负结算通过信号槽把状态变化广播出去。界面表现层View只负责把游戏状态画出来把用户的点击翻译成指令发给 Logic。这样做的好处答辩时可以直接说出来数据模型层不依赖 QT意味着你可以写纯 C 的单元测试游戏逻辑层和界面层用信号槽解耦意味着未来把 QWidget 换成 QML 界面或者加个网络对战版本逻辑层不用动。这三句话比你在答辩 PPT 上写十页系统简介都有说服力。2.2 核心类的设计与职责划分先定义一个最底层的Card 类它代表一张牌。花色用枚举点数用整数 2-14 表示11J12Q13K14A这样后面做牌型判断时可以直接比较数值大小。// card.h #ifndef CARD_H #define CARD_H enum class Suit { Spade, // 黑桃 Heart, // 红桃 Club, // 梅花 Diamond // 方块 }; class Card { public: Card(Suit suit, int rank) : m_suit(suit), m_rank(rank) {} Suit suit() const { return m_suit; } int rank() const { return m_rank; } // 用字符串描述一张牌比如 黑桃A QString toString() const { QString rankStr; switch (m_rank) { case 14: rankStr A; break; case 13: rankStr K; break; case 12: rankStr Q; break; case 11: rankStr J; break; default: rankStr QString::number(m_rank); } QString suitStr; switch (m_suit) { case Suit::Spade: suitStr 黑桃; break; case Suit::Heart: suitStr 红桃; break; case Suit::Club: suitStr 梅花; break; case Suit::Diamond: suitStr 方块; break; } return suitStr rankStr; } private: Suit m_suit; int m_rank; // 2 ~ 14 }; #endif // CARD_H这里的rank()返回 int 而不是直接返回字符串是为了后面排序和比较大小方便。很多新手会在这里存一张 QPixmap把牌面和算法搅在一起这是误区。界面显示的事情交给 View 层去做Model 层的 Card 就该是干干净净的数据。然后是Deck 类负责洗牌和发牌。洗牌算法用 Fisher-Yates也叫 Knuth 洗牌这是教科书级的写法答辩时老师问为什么不用随机排序你就可以解释直接对牌调用 qSort 然后放一个随机比较函数会让部分牌的位置概率不均Fisher-Yates 是理论上均匀的。// deck.cpp Deck::Deck() { m_cards.reserve(52); for (int suit 0; suit 4; suit) { for (int rank 2; rank 14; rank) { m_cards.append(Card(static_castSuit(suit), rank)); } } } void Deck::shuffle() { // Fisher-Yates 洗牌从后往前遍历每次随机取一张与当前位置交换 std::random_device rd; std::mt19937 gen(rd()); for (int i m_cards.size() - 1; i 0; --i) { std::uniform_int_distributionint dist(0, i); int j dist(gen); std::swap(m_cards[i], m_cards[j]); } } Card Deck::dealCard() { Q_ASSERT(!m_cards.isEmpty()); // 发牌前确认牌堆非空调试期帮你抓逻辑漏洞 return m_cards.takeLast(); // 从尾部取牌效率高于 takeFirst }注意dealCard()用了takeLast()而不是takeFirst()因为 QVector 从头部取元素是 O(n) 的要从尾部取。这个细节虽然影响不大但写到文档里就是考虑到性能的体现。Q_ASSERT是调试利器Release 模式下会自动消失不影响线上性能。2.3 信号槽连接表界面和逻辑的桥梁怎么搭Logic 层和 View 层之间通过 QT 的信号槽通信。我们设计一套协议信号触发时机参数含义界面层的响应gameStateChanged(GameState)阶段切换翻牌前 → 翻牌 → 转牌 → 河牌 → 摊牌当前处在哪个阶段更新中央公共牌区显示翻牌文字提示playerActed(int, PlayerAction)某玩家做了一次动作玩家索引、动作类型在日志区输出 玩家2 加注到 100potChanged(int)底池金额变动当前底池总额刷新底池 Label 显示currentPlayerChanged(int)轮到某玩家行动玩家索引高亮当前玩家的座位框启用/禁用操作按钮gameOver(int)一局结束获胜玩家索引弹出结算框显示获胜牌型在 MainWindow 里通过connect()把这些信号和槽函数关联起来槽函数里只做一件事更新界面上对应的控件。千万不要在槽函数里写游戏逻辑比如在onBetButtonClicked()里直接改玩家的筹码值——那会让状态散落一地答辩时老师问你这个筹码数据有几处维护你答不上来。逻辑层的核心是GameEngine 类它内部维护玩家列表、底池、公共牌、当前行动玩家索引并且提供playerAction(int playerIndex, BetAction action, int amount)这个入口。界面按钮被点击后调用这个方法把指令传进去引擎内部处理完再通过信号广播结果。这就是经典的单向数据流UI 事件 → Logic 处理 → 发出信号 → UI 刷新。答辩时画一张这样的数据流图放在论文里老师一眼就知道你懂工程分层这个思路比代码本身更值钱。3. Get 到核心算法牌型判断和下注轮转怎么写才能不出 bug3.1 7 选 5 的最大牌型判定一个函数解决所有情况德州扑克最终要比拼的是 5 张牌。你自己手里 2 张公共牌 5 张要从中选出 5 张组成最大牌型。最容易被新手写错的地方在于不是简单判断当前有哪些牌型特征而是要在 7 张里穷举所有 5 张组合C(7,5) 21 种分别计算牌型等级取最大。有同学图省事统计 7 张里每种点数的出现次数然后直接判是否四条、葫芦——这在大多数场景下是对的但边界情况会出错。经典的坑是两对选哪一对还有葫芦选三张一样加一对、而不是三张一样加另外一对更大的时候。最稳妥、最不容易被答辩老师挑刺的实现方式就是暴力枚举 21 种组合。7 张牌的组合数 C(7,5) 21对现代 CPU 而言这个计算量可以忽略不计。代码结构如下// HandEvaluator.cpp HandRank HandEvaluator::evaluate(const QVectorCard sevenCards) { HandRank best; best.level 0; // 枚举 7 张里选 5 张的所有组合用 5 层循环每层索引递增保证组合不重复 for (int a 0; a 3; a) { for (int b a 1; b 4; b) { for (int c b 1; c 5; c) { for (int d c 1; d 6; d) { for (int e d 1; e 7; e) { QVectorCard five { sevenCards[a], sevenCards[b], sevenCards[c], sevenCards[d], sevenCards[e] }; HandRank cur evaluateFive(five); if (cur best) { best cur; } } } } } } return best; }evaluateFive函数接收恰好 5 张牌分别判断同花、顺子、四条、葫芦、三条、两对、一对等。判断顺序从高级到低级代码里用 level 表示等级同等级再比点数。这里最有技术含量的是顺子判断先按 rank 从大到小排序再检查rank[i] - rank[i1] 1但要注意 A-2-3-4-5 这种特殊顺子A 要按 1 来算。常见做法是排序后额外判断一次5,4,3,2,A的排列是否存在。这个算法的时间复杂度是 O(21 * 排序开销)空间复杂度 O(1)在答辩时你可以主动讲出来。如果导师问有没有更快的方案你可以答用查表法把一副牌的 52 位用位向量表示做成哈希表缓存但毕业设计场景用不到显得你有广度。3.2 下注轮转的状态机拒绝 if 嵌套地狱游戏流程本质上是一个状态机。我见过有同学用一个巨大的 switch 套 if写着写着就把自己绕晕了。这里介绍一个更清晰的方案用枚举 状态转移表。enum class GameState { PreFlop, // 翻牌前每人发2张 Flop, // 翻牌公共牌3张 Turn, // 转牌公共牌第4张 River, // 河牌公共牌第5张 Showdown // 摊牌结算 }; // 状态转移表当前状态 - 下一个状态 GameState nextState(GameState s) { switch (s) { case GameState::PreFlop: return GameState::Flop; case GameState::Flop: return GameState::Turn; case GameState::Turn: return GameState::River; case GameState::River: return GameState::Showdown; default: return GameState::PreFlop; // Showdown 结束后重开一局 } }下注逻辑的关键在于一轮下注何时结束。规则是从庄家Button下家开始行动轮到庄家左边第一位玩家时一轮结束。但还有两个特殊情况有人加注时之前跟过注的玩家需要重新行动有玩家全下时如果只剩一个玩家在行动也要提前结束下注轮。我一般用一个简单的策略来管理每一轮开始时记录当前最大下注额和在本轮中已经行动过的玩家集合。每当有人加注就清空这个集合让所有还未重新行动的玩家再次行动。这个逻辑写成代码其实只有三五十行但却是整个游戏最容易出 bug 的地方也是答辩现场老师最爱问的地方。你要是这块讲清楚了基本就是做透了的信号。// 伪代码一轮下注的推进逻辑 void GameEngine::onPlayerBet(int playerIdx, int betAmount) { int maxBet currentMaxBet(); // 本轮当前最高下注额 if (betAmount maxBet) { m_maxBet betAmount; m_actedPlayers.clear(); // 有人加注清空已行动集合 } m_actedPlayers.insert(playerIdx); int nextIdx (playerIdx 1) % m_players.size(); // 跳过已弃牌玩家和已全下玩家 while (m_players[nextIdx]-isFolded() || m_players[nextIdx]-isAllIn()) { nextIdx (nextIdx 1) % m_players.size(); } // 如果除了一人之外其余都已弃牌或所有人都已行动且下注额相同本轮结束 if (allOtherFolded(nextIdx) || (m_actedPlayers.size() activePlayerCount() allBetsEqual())) { advanceToNextRound(); return; } setCurrentPlayer(nextIdx); }while循环跳过弃牌玩家的这段有必要展开说明如果当前玩家已弃牌你不能直接结束这轮下注而是要继续往下找下一个还在行动的人。有的同学会漏掉这一步结果轮到一个已经弃牌的玩家头上游戏就卡死了。这属于典型的看起来简单、实际跑起来就翻车的细节。3.3 底池分配多人全下的边池怎么算底池分配是德州扑克代码里最容易被忽略的难点。简单情况两个人玩一人全下一人跟注赢家拿走全部底池。但多人局里有人全下筹码少有人跟的多就需要分出主池Main Pot和边池Side Pot。很多网上源码直接不做边池拿回来就是阉割版。毕业设计里你要是把边池做出来属于明显的加分项。做法是按筹码从少到多逐层切分把所有参与该局玩家的本轮下注额收集起来按金额从小到大排序。从最小的下注额开始把所有人的下注额都扣掉这个最小值形成一个池子只有下注达到这个数额的人才有资格赢取这个池子。重复上述过程直到所有人都下注额归零。比如三个玩家分别下注 100、100、50。先切出 50 的层三人各 50 组成主池 150只有下注 50 的玩家参与剩下 50、50、0 再切一层下注 100 的两人各 50 组成边池 100由这两人竞争最终记录每个池子的获胜条件。这个逻辑用代码写起来大概 40 行但写清楚之后你的文档里就可以配一个底池分配流程图答辩时直接画给老师看。这里不贴完整代码了建议你把这个部分作为自己独立完成的代码来看待把每一步池子的金额和合格玩家列表记录到结构体里方便后面的结算阶段遍历。4. 界面搭建把算法穿上一件能看的衣服4.1 布局方案用布局管理器撑起整个牌桌德州扑克的界面布局是有讲究的。常见布局底部是自己的手牌和操作按钮区顶部是三家的玩家信息区中间是公共牌区。我建议用 QHBoxLayout 和 QVBoxLayout 组合尽量不要用绝对坐标 setGeometry——因为不同的屏幕分辨率和窗口拉伸会让绝对坐标的界面乱掉。推荐的控件层级是这样的根布局QVBoxLayout上部分QHBoxLayout里面放三个玩家信息面板QLabel 显示昵称/筹码/状态中部公共牌区用一个 QHBoxLayout 放 5 个 QLabel初始显示牌背图案下部操作区QHBoxLayout 放弃牌跟注加注全下四个按钮 一个 QSpinBox 输入加注额玩家数量做 2-6 人可配置即可。如果做三人模式上面的布局最简单每个玩家一个面板水平排开。如果要支持 6 人环形牌桌那就要用 QGridLayout 定位或者干脆用 QPainter 全自绘——后者工程量不小但视觉效果极佳。我建议毕业设计做 3 人或 4 人版本把精力省下来去完善对局记录和 AI 策略而不是死磕全自绘。4.2 用 QLabel 显示牌面最简单的落地路径显示一张扑克牌最省事的方案是QLabel setStyleSheet给标签设置背景色、边框和圆角中间写牌的文字用颜色区分红黑花色。十行代码搞定一张牌。// Widgets 里更新一张牌的显示 void updateCardLabel(QLabel* label, const Card card, bool faceUp) { if (!faceUp) { label-setText(?); label-setStyleSheet( background-color: #2c3e50; color: white; border: 2px solid #1a252f; border-radius: 8px; font-size: 20px; bold; min-width: 60px; min-height: 85px; ); return; } bool isRed (card.suit() Suit::Heart || card.suit() Suit::Diamond); label-setText(card.toString()); label-setStyleSheet(QString( background-color: white; color: %1; border: 2px solid #bdc3c7; border-radius: 8px; font-size: 18px; bold; min-width: 60px; min-height: 85px; ).arg(isRed ? #c0392b : #2c3e50)); }这里有个值得注意的细节min-width和min-height要在样式表里设置否则标签内容为空时显示不出来。牌背颜色用深蓝灰#2c3e50赢了底池高亮时可以用#27ae60变色边框,这些都是界面上的观感细节截图放进论文里会显得你很认真。比这更高级的做法是用 QPainter 自绘牌面仿照真实扑克的左上角点数和右下角镜像但工程量会翻两三倍我一般是告诉你加分的路径在哪但不盲目推荐毕竟一个毕业设计的核心还是把游戏逻辑做明白。4.3 定时器驱动自动操作家 docker 演示不卡场答辩演示最尴尬的场景你需要给老师展示游戏流程但要等自己操作太慢而且气氛很干。解决方式是在设置里做自动运行模式用 QTimer 定时让 AI 玩家自动做决策。这样你打开程序点一下自动演示四个人就能自己玩起来你只需要在旁边解说每一轮发生什么。// MainWindow 里开启自动演示模式 m_timer new QTimer(this); connect(m_timer, QTimer::timeout, this, MainWindow::onAutoPlayTick); m_timer-start(1200); // 每 1.2 秒自动行动一次 void MainWindow::onAutoPlayTick() { // 如果当前轮到人类玩家跳过或者也自动 if (m_engine-currentPlayerIndex() m_humanIndex) { int decision m_aiDecider-decide(m_engine-gameSnapshot()); m_engine-playerAction(m_humanIndex, decision.action, decision.amount); } refreshUI(); // 从引擎拉取最新状态并刷新界面 }这个onAutoPlayTick里的重点人类玩家也能被 AI 决策器接管这样整个游戏才能跑完整。要是你的 AI 写得不错可以加上AI 每轮决策耗时 1 秒的模拟思考时间演示效果会更好。定时器间隔做成了可配置的,既能加速演示又能让老师看清楚关键步骤。5. 避坑与排查QT 环境和 C 侧的 4 个经典翻车现场5.1 编译报错cannot mix incompatible Qt library版本混用的玄学现象项目在别人的电脑上编译运行正常拿到你的电脑上重新构建一编译就报fatal: cannot mix incompatible Qt library (version 0x50601) with this library。原因这个报错的本质是你链接的 Qt 库和你包含的头文件来自两个不同的 Qt 版本。最常见的诱发方式是电脑上装了 Qt 5.12 又装了 Qt 6.xCMake 或 qmake 找到的头文件是D:\Qt\6.5.0\include而链接库路径却指向了D:\Qt\5.12.12\lib。还有一种是用了 IDE 自带的 Qt 套件但环境变量PATH里被某个软件比如 Anaconda插入了其他版本的 Qt 路径。解决在 Qt Creator 里检查构建套件Kit对应的 Qt 版本是否和编译器匹配在项目文件里用QT core gui widgets依赖的是你用qmake或 CMake 指定的版本。建议先彻底卸载旧的 Qt 版本或者每次开项目前先执行qmake -v确认默认的 qmake 路径是不是你期望的那个。Windows 上尤其要注意PATH环境变量里的 Qt 目录顺序把它排在最后面避免被其他软件的 Qt 抢走。5.2 运行时报Could not find the Qt platform plugin linuxfb现象在 Linux 服务器上写好程序用./poker_game启动终端打印qt.qpa.plugin: could not find the Qt platform plugin linuxfb in 程序直接退出。原因这是缺少 Qt 平台插件。平时的桌面 Linux 用xcb嵌入式或纯命令行环境用linuxfb。如果你的 Qt 安装时没选对应组件或者运行时的QT_QPA_PLATFORM_PLUGIN_PATH没有指向插件目录就会报这个。解决在 Ubuntu 桌面上确认安装了libqt5gui5和libxcb-xinerama0用export QT_QPA_PLATFORMoffscreen可以先让程序跑起来适合截图测试正式演示时确保QT_QPA_PLATFORM_PLUGIN_PATH指向你 Qt 安装目录下的plugins/platforms文件夹。这条坑在你用平板或嵌入式设备跑跨平台音乐管理系统这类项目时也会遇到属于 QT 特有的环境问题建议写进文档的运行环境配置一节。5.3 洗牌算法翻车qSort(deck.begin(), deck.end(), randomCompare)的坑现象洗完之后发现某些牌经常出现在固定位置比如黑桃 A 总在最后几张。原因用随机比较函数做排序破坏了严格弱序strict weak ordering的公理整个排序行为是未定义的。有些 STL 实现甚至会在比较时无限循环让你的程序直接卡死。这种写法在一些旧博客里很常见属于典型的误导。解决用 Fisher-Yates 算法这段代码在上面已经贴出来了。如果不想自己实现C11 起可以用std::shuffle配合std::mt19937效果和 Fisher-Yates 一致。注意srand(time(NULL))rand()的方式在现代 C 里不是一个好选择rand()的随机质量不高而且线程不安全建议用std::random_device和std::mt19937。5.4 牌型判断漏掉A-2-3-4-5顺子现象对手手里拿着 A,2,3,4,5 的牌你的程序给判定成了高牌没有识别出顺子。原因判断顺子的常见写法是先排序再检查相邻两张牌的差值是否为 1比如rank[i] - rank[i1] 1。但 A 的 rank 是 14排序后是 14,5,4,3,2相邻差值依次是 9,1,1,1判定失败。这就是著名的轮子顺边界。解决在排序后的五张牌里额外判断一种情况max 14 min 2 剩余三张是 3,4,5。一个更通用的做法是把 A 同时映射成 1 和 14 两套 rank 值分别判断。类似这种边界问题在牌型判定里还有两个著名场景两对牌型里如果用一对较大值配一对较小值葫芦判定时要先找三条再从剩余里找对子而不是先找对子。5.5 QT 中文字体显示成方块的排查路径现象界面上所有中文都是口口口或者在某些 Linux 发行版上按钮文字完全不可见。原因Qt 的中文支持依赖系统的字体库Windows 一般自带宋体和微软雅黑没问题但 Linux 上如果没装中文字体包或者 Qt 找不到 fontconfig 配置就会显示成方块。另外在main.cpp里如果用了QTextCodec::setCodecForLocale老式写法在 Qt6 里直接编译不过——Qt6 默认 UTF-8不再需要这个调用。解决在main()函数开始处设置应用字体QApplication app(argc, argv); QFont font(Microsoft YaHei, 10); // Windows 上 app.setFont(font);如果在 Linux 上先确认系统有没有中文字体fc-list | grep -i song\|hei没有就安装fonts-wqy-microhei或fonts-noto-cjk。建议不要硬编码字体名而是用QFontDatabase检查系统可用字体后做一次选择这样一个代码包在 Windows 和 Linux 上都能正常显示。6. 收尾的加分动作用对局日志和自动化脚本让项目活起来如果你按前面的结构把代码写完项目和一般同学的毕业设计相比已经足够扎实。但还有两件事能明显拉开差距一是把对局日志写成文件二是用自动化脚本做回归测试。这两件事加起来工作量不超过一个下午但答辩演示效果差别很大。对局日志的做法很朴素在GameEngine里加一个logEvent(QString)信号把每一轮的动作串成文本发出去MainWindow里接住追加到一个QTextEdit里同时对局结束时写进game_log.txt。写这个文件要注意用QFile::append模式否则重开一局就覆盖了上一局的记录。void MainWindow::appendLog(const QString line) { m_logTextEdit-append(line); QFile file(game_log.txt); if (file.open(QIODevice::Append | QIODevice::Text)) { QTextStream out(file); out QDateTime::currentDateTime().toString(yyyy-MM-dd hh:mm:ss) line \n; } }自动回归测试的思路是把GameEngine写成不依赖界面的纯逻辑类然后在tests目录里写一个main.cpp定义几个手工构造的对局场景直接调用引擎的接口断言结果是否符合预期。比如玩家 A 手持皇家同花顺应该判定为赢过玩家 B 的四条多个玩家全下时边池分配总额等于总下注额。void testFlushBeatsStraight() { QVectorCard handA { Card(Suit::Heart, 10), Card(Suit::Heart, 11) }; QVectorCard handB { Card(Suit::Spade, 9), Card(Suit::Spade, 8) }; QVectorCard community { Card(Suit::Heart, 2), Card(Suit::Heart, 7), Card(Suit::Diamond, 14), Card(Suit::Club, 5), Card(Suit::Spade, 3) }; // A: 同花B: 顺子但 A 的同花大于 B 的顺子 } void testSidePotSplit() { // 三人全下的边池分配测试 // 玩家 A 下注 50B 下注 100C 下注 100 // 主池 150三人竞争边池 100B 和 C 竞争 }写完测试用例用命令行./poker_tests直接跑所有测试通过后打印ALL TESTS PASSED。把这行输出截图放进毕设论文的测试章节比任何语言都有说服力。这也是我做了这么多 QT 项目之后留下的习惯——永远不要在答辩前一天手动点按钮演示来证明程序没有 bug把这件事交给自动化脚本。最后说一个我自己的经验把文档的运行环境一节写好会省去大量答疑时间。别只写需要 QT要写清楚QT 5.15 或以上编译器 MSVC2019 或 MinGW 8.1.0CMake 3.16并说明在 Windows 上建议用 Qt Creator 自带的构建套件而不是手动配环境。这一步往往是同学之间互相拷项目时翻车最多的地方也是答辩时老师最容易亲手试探的一步。把这些细节落实到位你的毕业设计就不只是一堆能跑的代码而是一个别人拿到手能复现、能验证、能继续改的完整项目。希望这篇按从架构到排错的路径能帮到你——照着这个思路做你的 QT 德州扑克不仅能过答辩还能让老师认为这是一个真的做完了的项目而不是赶工缝合的演示品。本文还有配套的精品资源点击获取