简介：基于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、PyQt，Java的Swing、JavaFX，C#的WinForms、WPF，还有Web前端那套。选Qt而不是Java Swing，核心原因有两条：
第一，C++和Qt的组合性能好、形态原生，生成的程序是编译型可执行文件，不需要装额外运行时，打包出去就能跑，老师验收的时候不用折腾环境。
第二，Qt的信号槽（Signals & Slots）机制在事件驱动的游戏场景里有天然优势。你点击“要牌”按钮，触发hit()信号，游戏逻辑槽函数响应，更新界面——这套流程比Swing的监听器模式直观得多，也比手写事件循环省事得多。
我一个宿舍友当年用Java Swing做类似的项目，代码里全是ActionListener匿名内部类，改一个逻辑要翻好几处。Qt用信号槽把界面和逻辑解耦，做起来舒服太多。
1.3 整体架构简析
这个项目的架构很清晰，就是经典的界面层 + 逻辑层分离：
- 界面层（View）：
MainWindow负责整体布局，CardWidget负责单张牌的绘制，各种QPushButton、QLabel负责交互和反馈。 - 逻辑层（Model）：
GameEngine（或者叫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倍赔付。课设阶段如果你想简化，可以直接按普通胜利处理，但代码里最好预留这个判断。
- 庄家软17（Soft 17）：庄家拿到包含A且总点数恰好为17的情况（如A+6），这时候A按1计。有些赌场规则要求庄家继续要牌。课设阶段建议简化：庄家点数小于17时一律要牌，大于等于17时停牌，这样最简单，答辩也好解释。
- A的取值切换：一手牌里可能同时有一个A算11、另一个A算1，比如A+A+9 = 21，这个逻辑要处理对。核心方法是：先全按A=11算，若总点数超21，则每有一个A就减10。具体实现我放在后面代码环节细说。
2.2 牌堆与洗牌算法
牌堆（Deck）其实就是个向量。一副牌有52张，用QVector<int>或者标准库std::vector<int>存储，每种点数对应4张牌：1到10各4张（1代表A，2-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::vector<int>& 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，而且逻辑清晰，你拿A+A+9去验证（11+11+9=31，减10=21，再减10=11，取11为最终值），完全正确。
3. Qt界面设计与交互流程实现
3.1 整体布局：用布局器而不是手工定坐标
Qt界面设计第一课：不要用setGeometry()去手工指定控件坐标，横竖屏切换的时候你会哭的。用布局器（Layout），界面会自动适应窗口大小变化。
我实际采用的方案是：
- 中央部件用
QVBoxLayout做总布局，从上到下依次是：庄家区、中间功能区、玩家区。 - 庄家区和玩家区各用一个
QHBoxLayout横向排列，用来放牌的张数动态变化，所以不直接放控件进去，而是用一个QList<CardWidget*>管理所有牌控件，动态添加移除。 - 中间功能区放游戏状态提示（
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 牌面绘制：重写paintEvent
CardWidget继承自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，程序一运行就内存泄漏。建议统一用QList<CardWidget*>管理，手牌清空时遍历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做一个完整的应用”这件事，不再是什么遥不可及的事了。
以上，希望对你有帮助。
本文还有配套的精品资源，点击获取
