简介基于Qt 5.12打造的21点游戏完整课设工程主要面向需要掌握Qt GUI编程的初学者与计算机专业学生。项目实现玩家与电脑对战的经典Blackjack流程包含要牌、停牌、加倍等操作并涉及牌堆随机抽取、点数计算、爆牌判断与胜负逻辑。包体内含86个文件以C源码.cpp/.h、Qt界面设计.ui及大量扑克牌PNG素材为主另有程序图标与项目配置.pro/.qrc整体仅2.2MB结构精简便于直接编译运行与二次开发。已有1469人浏览学习适合作为课程设计参考或Qt实战入门项目。通过阅读源码可系统学习信号与槽、布局管理、自定义窗口绘制、资源文件加载等关键知识点并理解一个完整小游戏的模块划分与工程组织方式为后续扩展动画、音效或多人在线功能打下基础。 朋友如果你正在为课程设计选题发愁想找个既练手又有展示效果的题目Qt可视化界面版21点游戏是个很不错的选择。它麻雀虽小五脏俱全涉及GUI布局、信号槽机制、事件处理、随机算法、状态机设计这些Qt开发里的核心知识点做完这个项目你对Qt的理解基本能碾压班里大部分同学。先说说这文章是干嘛的我把自己做这个课设的完整过程、代码思路、踩过的坑全掰开揉碎写出来从规则设计到AI逻辑从界面布局到动态交互再到最后的口头答辩话术你照着这条路走一遍不仅能交出一个漂亮的作品还能真真正正搞明白“用Qt做一个带界面的小游戏”这件事到底是怎么回事。1. 项目全貌与核心设计思路1.1 为什么要选“21点”这个题目课设选题这件事门道挺多。选太简单的比如计算器、记事本答辩时老师一眼就看出你没花心思分上不去选太复杂的比如搞个电商系统、网络聊天室你又很难在短时间内做完最后容易烂尾。21点Blackjack恰好卡在中间规则简单玩法大众但实现起来需要动脑子又有天然的视觉表现力——扑克牌、计分、胜负判定这些东西做出来好看答辩也有东西可讲。更重要的是21点游戏的逻辑天然适合用状态机来建模。玩家点“要牌”的时候游戏处于什么状态点“停牌”之后应该做什么庄家翻底牌之后又要走什么流程……这些都是清晰的状态迁移用Qt的信号槽来驱动状态流转整个代码结构会很清爽老师问你“为什么这么设计”的时候你能讲出个一二三来。1.2 技术选型为什么是Qt而不是别的市面上做GUI的方案不少Python的Tkinter、PyQtJava的Swing、JavaFXC#的WinForms、WPF还有Web前端那套。选Qt而不是Java Swing核心原因有两条第一C和Qt的组合性能好、形态原生生成的程序是编译型可执行文件不需要装额外运行时打包出去就能跑老师验收的时候不用折腾环境。第二Qt的信号槽Signals Slots机制在事件驱动的游戏场景里有天然优势。你点击“要牌”按钮触发hit()信号游戏逻辑槽函数响应更新界面——这套流程比Swing的监听器模式直观得多也比手写事件循环省事得多。我一个宿舍友当年用Java Swing做类似的项目代码里全是ActionListener匿名内部类改一个逻辑要翻好几处。Qt用信号槽把界面和逻辑解耦做起来舒服太多。1.3 整体架构简析这个项目的架构很清晰就是经典的界面层 逻辑层分离界面层ViewMainWindow负责整体布局CardWidget负责单张牌的绘制各种QPushButton、QLabel负责交互和反馈。逻辑层ModelGameEngine或者叫BlackjackGame负责牌堆管理、发牌、计分、胜负判定Deck封装一副牌的数据结构Player和Dealer是参与游戏的双方。为什么要分离因为课设答辩的时候老师一定会问“你这个逻辑和界面是耦合在一起的吗”如果你能拍着胸脯说“逻辑层完全不依赖Qt的界面类独立运行也能用”这个回答在答辩时非常加分。而且分离之后逻辑层可以写单元测试调试方便太多。我实际做完的体会是把纯C逻辑和Qt界面分开写调试体验极其舒服因为很多时候逻辑错了和界面错了要排查的方向完全不一样。2. 核心玩法逻辑建模与实现2.1 规则梳理不只是“比大小”21点的规则大家都听过但作为开发者你得像写需求文档一样把规则拆细不然代码写到一半会发现各种边界情况没处理。基本规则使用一副或多副52张扑克牌不含大小王2~10按牌面计分J/Q/K计10分A可计1分或11分取不爆牌的最优值玩家先行动可选“要牌”Hit或“停牌”Stand要牌后总点数超过21即“爆牌”直接判负玩家停牌后庄家揭开自己的底牌然后强制要牌直到点数≥17最终比较双方点数点数大者胜相等则平局Push还有一些必须处理的边界情况Blackjack黑杰克开局两张牌点数之和为21一张A 一张10点牌这是最大的牌型通常按1.5倍赔付。课设阶段如果你想简化可以直接按普通胜利处理但代码里最好预留这个判断。庄家软17Soft 17庄家拿到包含A且总点数恰好为17的情况如A6这时候A按1计。有些赌场规则要求庄家继续要牌。课设阶段建议简化庄家点数小于17时一律要牌大于等于17时停牌这样最简单答辩也好解释。A的取值切换一手牌里可能同时有一个A算11、另一个A算1比如AA9 21这个逻辑要处理对。核心方法是先全按A11算若总点数超21则每有一个A就减10。具体实现我放在后面代码环节细说。2.2 牌堆与洗牌算法牌堆Deck其实就是个向量。一副牌有52张用QVectorint或者标准库std::vectorint存储每种点数对应4张牌1到10各4张1代表A2-10按面值J/Q/K统一记为10总共52个元素。洗牌算法我用的是std::shuffle配合std::mt19937随机数引擎#include random #include algorithm void Deck::shuffle() { std::random_device rd; std::mt19937 g(rd()); std::shuffle(cards.begin(), cards.end(), g); }这里有个关键坑不要用传统的rand() % 52去洗牌一是随机性不够好二是很多教程会建议你用srand(time(NULL))做种子但同一秒内rand()序列是相同的导致两次开局牌序一模一样非常尴尬。std::mt19937配合random_device生成种子质量好答辩时也能顺口说出“用梅森旋转算法保证随机性”显得专业。如果要加难度可以模拟多副牌比如6副牌把52张牌复制6份再洗。但课设阶段我建议就一副牌代码简单逻辑清楚效果也够。2.3 计分逻辑A的灵活处理计分函数是整个逻辑层最核心的函数没有之一int GameEngine::calculateHandValue(const std::vectorint hand) { int total 0; int aceCount 0; for (int card : hand) { if (card 1) { aceCount; total 11; } else { total card; } } while (total 21 aceCount 0) { total - 10; aceCount--; } return total; }逻辑拆开看先把所有A按11分算进总点数然后检查是否爆牌如果爆了就依次把A从11降成1每个A降一次总分减10。这个算法能处理任意数量的A而且逻辑清晰你拿AA9去验证1111931减1021再减1011取11为最终值完全正确。3. Qt界面设计与交互流程实现3.1 整体布局用布局器而不是手工定坐标Qt界面设计第一课不要用setGeometry()去手工指定控件坐标横竖屏切换的时候你会哭的。用布局器Layout界面会自动适应窗口大小变化。我实际采用的方案是中央部件用QVBoxLayout做总布局从上到下依次是庄家区、中间功能区、玩家区。庄家区和玩家区各用一个QHBoxLayout横向排列用来放牌的张数动态变化所以不直接放控件进去而是用一个QListCardWidget*管理所有牌控件动态添加移除。中间功能区放游戏状态提示QLabel、控制按钮开始、要牌、停牌、重新开局。实际操作时布局和代码是这样组织的// 主窗口构造函数中的布局搭建 CentralWidget new QWidget(this); setCentralWidget(CentralWidget); QVBoxLayout* mainLayout new QVBoxLayout(CentralWidget); // 庄家区 dealerSectionLabel new QLabel(庄家, CentralWidget); dealerCardsLayout new QHBoxLayout(); mainLayout-addWidget(dealerSectionLabel); mainLayout-addLayout(dealerCardsLayout); // 中间功能区 statusLabel new QLabel(点击“开始游戏”继续, CentralWidget); mainLayout-addWidget(statusLabel); // 玩家区 playerSectionLabel new QLabel(玩家, CentralWidget); playerCardsLayout new QHBoxLayout(); mainLayout-addWidget(playerSectionLabel); mainLayout-addLayout(playerCardsLayout); // 控制按钮区 btnStart new QPushButton(开始游戏, CentralWidget); btnHit new QPushButton(要牌, CentralWidget); btnStand new QPushButton(停牌, CentralWidget); QHBoxLayout* buttonLayout new QHBoxLayout(); buttonLayout-addWidget(btnStart); buttonLayout-addWidget(btnHit); buttonLayout-addWidget(btnStand); mainLayout-addLayout(buttonLayout);为什么不直接往QHBoxLayout里塞QLabel显示牌面而是搞个CardWidget类因为纯文字显示牌太丑了而且没法体现翻牌动画效果。自己绘制牌面视觉效果好得多答辩演示的时候能镇住场子。3.2 牌面绘制重写paintEventCardWidget继承自QWidget重写paintEvent方法绘制一张扑克牌。牌面包括左上角的点数符号、中央的花色图标、背景色。void CardWidget::paintEvent(QPaintEvent*) { QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing); // 绘制白色圆角背景模拟扑克牌 QRectF rect(2, 2, width()-4, height()-4); painter.setPen(QPen(Qt::black, 2)); painter.setBrush(QBrush(Qt::white)); painter.drawRoundedRect(rect, 8, 8); // 扑克牌背面的情况 if (!faceUp) { painter.setBrush(QBrush(QColor(0, 82, 155))); painter.drawRoundedRect(rect, 8, 8); return; } // 绘制点数和花色 QString suitSymbol; QString numberText; // 根据suit和value解析出符号和数字 // ... painter.setPen(getSuitColor()); // 红桃/方块红色黑桃/梅花黑色 QFont font painter.font(); font.setPointSize(14); font.setBold(true); painter.setFont(font); painter.drawText(QPoint(10, 25), numberText); painter.drawText(QPoint(10, 45), suitSymbol); }关于牌的显示我用的是用Unicode字符表示花色红桃♥、方块♦、黑桃♠、梅花♣。显示效果比ASCII强得多而且不用贴图片资源代码干净。3.3 信号槽联动完整游戏流程信号槽是Qt的灵魂这个项目的交互全部靠它驱动。我用文字完整串一遍游戏流程点击“开始游戏”发出startGame()信号逻辑层进入Ready状态。发牌玩家和庄家各发2张庄家第二张牌背面朝上faceUp false。状态为PlayerTurn此时“要牌”和“停牌”按钮可用“开始游戏”按钮不可用。点击“要牌”发出hit()信号 → 玩家手牌加一张 → 检查是否爆牌 → 刷新界面。如果爆牌状态转GameOver弹出提示框显示“玩家爆牌庄家胜”。如果没爆继续等待玩家操作。点击“停牌”发出stand()信号 → 庄家翻开底牌 → 庄家阶段自动循环要牌可以用一个定时器QTimer::singleShot实现逐张发牌的效果视觉上更好看→ 直到庄家点数≥17。比较双方点数弹出结算框状态转GameOver。点击“重新开始”发resetGame()信号清空桌面回到状态1。按钮的启用与否可以用setEnabled(bool)控制也可以更优雅地用一个全局状态枚举在每次状态切换时统一刷新按钮可用性。我个人推荐后者代码维护起来容易太多。3.4 交互细节优化几个提升答辩效果的细节实际开发时容易发现动画效果用QPropertyAnimation给牌加一个“从牌堆滑到桌上”的移动效果。其实不复杂但视觉体验提升巨大答辩时老师看到牌是“飘”下来的而不是瞬间出现的好感度直接拉满。我实现时用QPropertyAnimation控制卡片的geometry属性动态移动位置耗时约300ms非常自然。状态提示在界面中央用QLabel显示当前游戏状态“你的回合请选择要牌或停牌”“庄家回合”“你赢了”“庄家获胜”。这个提示是用户理解游戏流程的关键也是答辩时讲解流程的辅助线索。计分板在当前分数旁边放一个QLabel实时显示手牌点数。这个看着简单但对体验提升很大因为玩家不用自己心算点数了也更直观地展示了你的计分逻辑。4. 进阶锦上添花双人模式与声音4.1 双人对战模式如果你的课设时间比较充裕或者想冲一个更高的分数可以考虑加一个“双人模式”。规则变体是两名玩家轮流行动都停牌后比较点数更接近21点的获胜。实现要点游戏状态机从“玩家1的回合 → 玩家2的回合 → 双方停牌后比较”过渡。界面需要支持切换当前玩家可以在状态标签里显示“当前行动玩家1/玩家2”。逻辑层需要维护两个Player对象相当于一个简易的多人游戏框架。更复杂的双人对战版本还可以加入叫牌/抢牌的博弈规则但这对于课设来说太复杂了。能实现基础版本已经足够展示你对状态机的理解。4.2 音效添加用QSoundEffect类需要Qt Multimedia模块播放简单的音效发牌时的“嗒”声、翻牌时的“啪”声、爆牌时的“轰”声。也可以在GitHub上找免费的开源音效素材用QSoundEffect播放即可。这个加分项成本极低但效果其实很好。我做完后给室友演示他第一反应是“这游戏怎么这么有感觉”就凭这句话我觉得值了。需要提醒的是在.pro文件里加上QT multimedia否则编译不过。5. 避坑指南与答辩经验5.1 Qt项目里高频踩坑点这里把我做项目过程中遇到的实际问题整理出来希望你不用再走一遍弯路坑一随机种子问题。旧代码用srand(time(NULL))配合rand()会导致同一秒内两次开局牌序完全一样第一次玩还能接受第二次就觉得是bug了。解决办法就是前面说的std::mt19937。坑二内存释放问题。动态添加的牌控件需要显式管理生命周期。有些同学用裸new创建控件却忘了delete程序一运行就内存泄漏。建议统一用QListCardWidget*管理手牌清空时遍历delete再把QList清空或者直接用QSharedPointer配合Qt的父子对象机制。坑三信号槽连接忘记解除。如果你用了Lambda表达式做槽函数里面捕获了this但没注意连接关系反复“开始-重新开局”后同一个按钮的点击事件可能连着多次发牌逻辑。因为每次connect都新增一个连接槽函数被调用多次。解决办法是在重新初始化时调用disconnect()或者用Qt::UniqueConnection。坑四窗口缩放后的布局错乱。如果你用了setGeometry硬编码坐标窗口一拉伸就惨不忍睹。Qt的理念是用QHBoxLayout、QVBoxLayout、QGridLayout组合让布局器自动管理。坑五忘记添加QT widgets。新创建Qt Widgets项目时.pro文件里没加这个模块的话编译会报一堆“找不到头文件”的错初学者可能被劝退。5.2 代码组织和文件规范课设答辩最怕的就是被问“你的代码组织得好吗”我建议的目录结构Blackjack/ ├── Blackjack.pro # 项目文件 ├── main.cpp # 程序入口 ├── mainwindow.h/cpp # 主窗口界面布局与信号槽连接 ├── gameengine.h/cpp # 游戏逻辑引擎 ├── deck.h/cpp # 牌堆数据结构 ├── cardwidget.h/cpp # 牌绘制控件 └── resources.qrc # 资源文件如音效、图标这样一个文件负责一件事结构一目了然。重点是把GameEngine做成纯逻辑类不依赖任何Qt界面组件顶多用QVector/QString这种基础类型这样编译测试逻辑时甚至不需要启动GUI可以写一个博客开头提到过的命令行测试入口来验证逻辑。5.3 答辩演示话术演示的时候按这个顺序来先讲规则一句话说清21点怎么玩展示你懂需求。再结构明确告诉老师“我的代码分为逻辑层和界面层两层逻辑层不依赖界面”然后点开文件列表快速展示一次。演示核心流程正常要牌、停牌、庄家翻底牌、结算——走一个完整的游戏回合。有动画效果最好因为视觉呈现是老师从感官上评估项目质量的最直接渠道。演示边界情况故意爆牌一次展示错误处理逻辑。回答技术细节大概率会被问“A的点数怎么处理”直接把calculateHandValue翻出来讲一遍说“A先按11算爆了就每个A减10只减到21以内为止。”5.4 评审老师常问的问题提前想好答案几个高频问题和对应回答思路问你为什么用Qt而不是其他框架答Qt有信号槽机制适合事件驱动的交互逻辑跨平台同一套代码能在Windows、macOS、Linux上跑自带的布局器快速实现动态界面开发文档完善、社区生态成熟。问你的洗牌算法是什么答std::shuffle配合梅森旋转伪随机数发生器而不是传统的rand() % 52因为前者周期长、随机性好。问如果玩家有5张牌但点数还是12怎么算答根据规则5张牌且点数不超过21算特殊牌型“五小龙”直接判胜。这个可以在代码里加入判断逻辑增加一些可演示的加分项。问如果玩家和庄家都是21点谁赢答平局Push退还赌注。返回胜负结果时可以单独用枚举值Draw表示。问你如何测试你的逻辑层答逻辑层是独立的纯C类可以在一开始就写一个main()测试入口手工构造固定手牌调用calculateHandValue验证计分正确性。6. 演示录制与展示技巧课设圈额外的加分项我跟不少同学聊过很多人做完项目就以为结束了。实际上课设的“展示”环节占的分数比重远超你想象。我做完Qt版21点后顺手录了一个2分钟演示视频效果特别好。录制时可以注意窗口尺寸别太大固定在一个能完整展示牌桌的尺寸。开始前先展示代码工程目录结构快速“过一眼”再切入运行演示。操作节奏放慢一点让每个动作都有回应同时语言解说“当前是玩家回合”“现在庄家翻开底牌”“庄家总点数不足17继续要牌”。故意展示一次“爆牌”的失败场景再展示一次“黑杰克Blackjack”的获胜场景让自己看起来对边界情况了如指掌。这样录出来的视频发到课程群或者答辩PPT里会让人家觉得你的完成度不止是一个及格课设而是真的花了心思。7. 最后分享几个小技巧和体会做完这个项目有几个细节技巧是我实际开发中摸索到的写了代码才知道不是每个教程都会告诉你。第一个是关于界面初始化的状态管理。刚启动程序时“要牌”“停牌”按钮应该禁用等点了“开始游戏”再启用否则玩家可以在游戏没开始时就点“要牌”逻辑层会懵。我在setGameState()函数里统一管理所有按钮的setEnabled状态每次游戏状态迁移时刷新一次按钮状态代码里所有入口都在同一处控制非常省心。第二个是卡牌发牌动画的心得。用QPropertyAnimation实现卡牌滑动时卡片的geometry属性要从起点动画到目标位置。我一开始直接把新牌添加进布局发现牌是瞬间出现的画面特别突兀。改用动画之后300ms的滑动动画让整个游戏体验顺畅很多。注意动画过程中要暂时忽略布局器否则布局会自动重新排列动画就乱了。我的做法是先把新牌addWidget进布局然后立刻设置geometry动画动画期间布局不会重新计算效果刚好。第三个是对手牌区域的布局处理。牌是动态增加减少的如果直接用QHBoxLayout往里面塞牌牌多了会挤压变形。我用的是固定数量的“牌槽”比如最多6个槽位每次更新手牌时把已有的牌按顺序放入槽位牌与牌之间有点重叠效果看起来就像真实的牌桌一样。具体做法是给每个牌槽设置固定宽度牌之间重叠约40%超出部分裁剪。这个效果很耐看答辩时老师还特意夸了一下。第四个是调试技巧。Qt Creator的调试器对C的支持很好但你最好在游戏逻辑关键函数里加qDebug()输出比如每次发牌后输出当前手牌和点数。开着调试输出打牌逻辑错在哪一目了然。等全部跑通了再注释掉调试语句或者用#ifdef DEBUG宏包起来这样正式版代码不会满屏输出但需要调试时随时能打开。最后说一下个人的真实体会。做课设这件事很多人把它当成一种负担随便糊弄过去。但实际上大学里能让你接触完整项目开发流程的机会就这么几个尤其是Qt这种GUI框架真正做到“既能运行、又有界面、逻辑还清楚”的项目对你的编程能力、调试能力、系统设计能力都是实打实的锻炼。我自己做这个21点的过程中从最初连布局器都不会用到后来能独立处理动态控件、定制绘制、动画效果成长真的是肉眼可见的。如果你正在做这个题目的课设照着上面的思路一步一步来先搭骨架再填细节逻辑层跑通再画界面一个能打的作品其实没那么难。做完之后你会发现“用C和Qt做一个完整的应用”这件事不再是什么遥不可及的事了。以上希望对你有帮助。本文还有配套的精品资源点击获取