# 基于 C++ 与 Qt 的欢乐斗地主游戏项目设计与实现

## 摘要

欢乐斗地主是国内流行的扑克棋牌类游戏，具备规则清晰、交互性强的特点。本文采用 C++ 作为底层业务逻辑开发语言，Qt 框架搭建图形界面，完成一款单机版欢乐斗地主系统。项目实现扑克牌生成、洗牌发牌、叫地主、抢地主、出牌校验、牌型识别、胜负判定、动画交互等核心功能。文章从需求分析、总体架构、核心模块设计、关键代码实现、界面设计、测试结果、项目总结等方面完整阐述，适合作为 C++ Qt 综合实训项目、课程设计参考。
**关键词**：C++；Qt；欢乐斗地主；棋牌游戏；图形界面；牌型算法
## 一、项目概述

### 1.1 项目背景

斗地主属于三人扑克游戏，使用一副 54 张扑克牌（包含大小王），一名地主对战两名农民。传统桌面棋牌游戏可以借助 Qt 快速开发跨平台桌面程序，Qt 自带信号槽机制、绘图系统、定时器、布局控件，非常适合卡牌类交互游戏开发。C++ 保证游戏逻辑运行效率，适合处理大量牌型判断、状态流转。
本项目定位**单机版欢乐斗地主**，电脑 AI 充当另外两名玩家，玩家手动操作叫地主、出牌、不出，不需要网络通信，降低开发复杂度，聚焦牌型算法与界面交互。
### 1.2 功能需求


1. 基础卡牌功能：生成 54 张扑克牌、洗牌、自动发牌，预留 3 张底牌；

2. 叫地主流程：轮到玩家、AI 依次抢地主，可选择抢 / 不抢；

3. 牌型识别：支持单张、对子、三张、三带一、三带二、顺子、连对、飞机、炸弹、王炸；

4. 出牌校验：判断当前出牌是否大于上家牌、是否符合牌型规则；

5. 游戏状态管理：等待叫地主、地主出牌、农民出牌、游戏结束；

6. AI 简单出牌逻辑：能选择压牌或者选择不出；

7. UI 交互：卡牌拖拽 / 点击选中、出牌动画、底牌显示、玩家身份标识、胜负弹窗；

8. 辅助功能：重新开局、游戏提示、牌面放大显示。


### 1.3 开发环境


- 开发语言：C++11 及以上

- UI 框架：Qt 5.15 / Qt6（推荐 Qt5 兼容性更好）

- 开发工具：Qt Creator

- 编译套件：MinGW / MSVC

- 技术要点：Qt 信号与槽、QPainter 自定义绘图、QTimer 定时器、容器（QVector、QList）、面向对象编程


## 二、总体架构设计

项目采用面向对象分层设计，分为三层：**数据模型层、游戏逻辑层、UI 展示层**，解耦界面和业务逻辑，方便后期扩展联网、增加 AI 难度。

1. **数据模型层（Model）**
	- Card：扑克牌类，存储花色、点数、权重、图片路径；
	- Player：玩家基类，分为 HumanPlayer（玩家）、AIPlayer（电脑），保存手牌、身份（地主 / 农民）；

2. **游戏逻辑层（GameCore）**
	- LandlordGame：游戏核心控制类，管理洗牌、发牌、叫地主、出牌校验、胜负判断；
	- CardRule：牌型规则工具类，静态方法识别牌型、比较牌大小；

3. **UI 展示层（View）**
	- MainWindow：主窗口；
	- CardWidget：卡牌自定义控件，负责绘制卡牌、选中效果；
	- GamePanel：游戏面板，渲染三方手牌、出牌区、底牌；
	- Dialog：弹窗（游戏结束弹窗、提示框）


整体流程：程序启动 → 初始化 54 张牌 → 洗牌发牌 → 叫地主阶段 → 确定地主 → 轮流出牌 → 检测胜利 → 弹窗结算 → 支持重新开局。
## 三、核心类设计

### 3.1 扑克牌 Card 类设计

卡牌需要设置权重，用于大小比较，统一规则：
3<4<5<6<7<8<9<10<J<Q<K<A<2 < 小王 < 大王
```
class Card
{
public:
    //花色：黑桃、红桃、梅花、方块、小王、大王
    enum Suit {SPADE, HEART, CLUB, DIAMOND, SMALL_JOKER, BIG_JOKER};
    Card(int point, Suit suit);
    int getPoint() const;
    Suit getSuit() const;
    int getWeight() const; //权重，比较大小使用
    QString getImgPath() const;

private:
    int m_point;
    Suit m_suit;
    int m_weight;
};
```### 3.2 玩家 Player 类

```
class Player
{
public:
    enum Role {FARMER, LANDLORD};
    Player();
    void addCard(const Card& c);
    void clearCard();
    QVector<Card> getHandCards();
    void setRole(Role r);
    Role getRole();
protected:
    QVector<Card> m_handCards;
    Role m_role = FARMER;
};

class HumanPlayer : public Player
{
    //玩家：支持选中卡牌
public:
    QVector<Card> getSelectedCards();
    void selectCard(int idx);
private:
    QVector<int> m_selectedIndex;
};

class AIPlayer : public Player
{
public:
    //AI自动选择出牌
    QVector<Card> autoPlay(const QVector<Card>& lastCards);
};
```### 3.3 牌型枚举与 CardRule 工具类

牌型类型定义：
```
enum CardType
{
    TYPE_ERROR,      //非法牌型
    TYPE_SINGLE,     //单张
    TYPE_PAIR,       //对子
    TYPE_THREE,      //三张
    TYPE_THREE_ONE,  //三带一
    TYPE_THREE_TWO,  //三带二
    TYPE_STRAIGHT,   //顺子
    TYPE_STRAIGHT_PAIR,//连对
    TYPE_PLANE,      //飞机
    TYPE_BOMB,       //炸弹
    TYPE_ROCKET      //王炸
};
```CardRule 提供两个核心静态函数：

1. `CardRule::getCardType(QVector<Card> cards)`：识别传入手牌是什么牌型；

2. `CardRule::isBigger(QVector<Card> last, QVector<Card> cur)`：判断当前牌能否压过上家。


>核心规则要点：
- 王炸最大，可以压所有牌；炸弹大于普通牌；
- 同牌型才能比较大小（炸弹、王炸除外）；
- 顺子、连对必须点数连续，2、大小王不能进入顺子；
- 三带一、三带二比较三张的点数，附带牌不参与比较。

### 3.4 游戏核心 LandlordGame

负责全局状态流转：
```
enum GameStatus
{
    STATUS_WAIT_CALL,   //等待抢地主
    STATUS_PLAYING,     //出牌阶段
    STATUS_GAME_OVER    //游戏结束
};
class LandlordGame : public QObject
{
    Q_OBJECT
public:
    LandlordGame();
    void startGame();
    void shuffle();
    void dealCard();
    void callLandlord(bool isGrab);
    void playCard(QVector<Card> cards);
signals:
    void statusChanged(GameStatus s);
    void refreshUI();
private:
    GameStatus m_status;
    QVector<Card> m_allCards;
    QVector<Card> m_bottomCards;
    HumanPlayer m_player;
    AIPlayer m_ai1, m_ai2;
    int m_currentPlayer; //当前轮到谁
    QVector<Card> m_lastOutCards; //上家出的牌
};
```## 四、关键算法实现说明

### 4.1 洗牌算法

采用 Fisher-Yates 洗牌算法，随机交换数组元素，保证随机性：
```
void LandlordGame::shuffle()
{
    for(int i = m_allCards.size()-1; i>0; i--)
    {
        int randIdx = qrand() % (i+1);
        std::swap(m_allCards[i], m_allCards[randIdx]);
    }
}
```### 4.2 牌型识别思路（简要逻辑）


1. 将传入卡牌按权重从小到大排序；

2. 统计每个点数出现次数，生成频次 map；

3. 根据卡牌数量 + 频次分布判断牌型：
	- 5 张连续、无 2、无王 → 顺子；
	- 两对及以上连续对子 → 连对；
	- 四张同点 → 炸弹；
	- 大小王一起 → 王炸；
	- 三张 + 单张 → 三带一；三张 + 对子 → 三带二。


>难点：顺子长度不固定（5~12 张），需要校验连续；飞机包含多组三张，逻辑相对复杂，课程设计版本可以优先实现常用牌型。

### 4.3 AI 出牌逻辑（简易版）

简易 AI 策略适合课程设计：

1. 如果上家不出，优先出最小能出的牌；

2. 如果上家出牌，先看手里有没有能压住的牌；

3. 有可以压的牌，选择最小的牌去压；没有就选择不出；


>拓展方向：可以后续改成贪心 AI、记牌 AI，提升难度。

## 五、Qt 界面设计

### 5.1 布局规划

主窗口分为 4 个区域：

1. 左上：AI1（农民 / 地主）手牌区；

2. 右上：AI2（农民 / 地主）手牌区；

3. 底部：玩家手牌区，支持点击选中卡牌；

4. 中间：出牌区域 + 底牌区域；
	底部放置按钮：【抢地主】【不抢】【出牌】【不出】【重新开始】。


### 5.2 卡牌绘制方案

两种实现方式：
方案 1：使用 QPushButton，设置样式表 + 卡牌图片，简单快速，适合快速开发；
方案 2：自定义 CardWidget，重写`paintEvent(QPaintEvent *)`，使用 QPainter 绘制卡牌、边框、选中高亮效果，效果更好，自由度更高。
```
void CardWidget::paintEvent(QPaintEvent *event)
{
    QWidget::paintEvent(event);
    QPainter painter(this);
    if(m_selected)
    {
        painter.setPen(QPen(Qt::red,2));
    }
    painter.drawPixmap(rect(), QPixmap(m_card.getImgPath()));
}
```卡牌资源：准备 54 张扑克牌 png 图片，放到 qrc 资源文件中，Qt 资源系统加载。
### 5.3 信号槽联动

游戏核心 LandlordGame 逻辑类和 MainWindow 解耦：
游戏内部状态变更后发送`refreshUI()`信号，窗口接收信号，重新绘制所有手牌、出牌区、刷新按钮状态。
>例如：叫地主完成后，刷新底牌显示，隐藏抢地主按钮，激活出牌按钮。

## 六、项目运行流程演示


1. 点击【重新开局】，程序生成 54 张牌、洗牌、发牌，3 张底牌隐藏；

2. 进入抢地主阶段，依次轮到玩家、AI 抢地主；

3. 确定地主后，底牌发给地主，地主优先出牌；

4. 玩家点击手牌选中卡牌，点击【出牌】提交；校验牌型合法并且大于上家才能打出；

5. 玩家选择不出，则轮到下家 AI 操作；

6. 任意一方手牌全部出完，判定胜负，弹出提示：地主胜利 / 农民胜利；

7. 点击确定，回到初始界面，可以重新开局。


## 七、项目难点与解决方案


1. **难点：牌型判断逻辑复杂，容易漏判**
	解决：把牌型判断独立成 CardRule 工具类，分单元测试，逐个牌型单独调试；先实现基础牌型，再扩展顺子、飞机。

2. **难点：界面卡牌选中、重叠排布**
	解决：手牌横向偏移排布，每张卡牌 x 坐标叠加偏移量；选中卡牌向上偏移，视觉区分。

3. **难点：游戏状态混乱，抢地主和出牌按钮冲突**
	解决：增加 GameStatus 状态机，根据状态控制按钮 enable，不同阶段只开放对应操作按钮。

4. **难点：AI 逻辑不好写**
	解决：课程设计采用简易 AI，优先保证主流程跑通，AI 只做基础压牌逻辑，不做复杂记牌。


## 八、项目拓展方向

本单机版本是基础版本，可以继续迭代升级：

1. 增加网络模块：基于 Qt 网络 Tcp，实现局域网双人 / 三人联机斗地主；

2. 升级 AI 算法：增加记牌、拆牌策略，AI 难度分级；

3. 增加音效：出牌音效、抢地主音效、胜利音效（QSound）；

4. 增加动画：卡牌飞出、翻牌动画，使用 QPropertyAnimation；

5. 增加积分系统、对局记录；

6. 适配移动端（Qt for Android）。


## 九、总结

本项目基于 C++ 和 Qt 实现单机欢乐斗地主，完整覆盖棋牌游戏开发的典型流程：数据建模、状态机控制、复杂规则算法、自定义绘图 UI 交互。项目充分利用 C++ 面向对象思想拆分模块，借助 Qt 信号槽实现逻辑层和界面层解耦。
项目代码量适中，难度适合高校 C++ 课程设计、Qt 实训大作业。项目不仅可以巩固 C++ 基础、容器、面向对象，还可以掌握 Qt 绘图、信号槽、资源文件等核心知识点。棋牌游戏本身扩展性很强，单机版本是很好的起点，后续可以向联机对战方向继续开发。

欢乐斗地主是国内流行的扑克棋牌类游戏，具备规则清晰、交互性强的特点。本文采用 C++ 作为底层业务逻辑开发语言，Qt 框架搭建图形界面，完成一款单机版欢乐斗地主系统。项目实现扑克牌生成、洗牌发牌、叫地主、抢地主、出牌校验、牌型识别、胜负判定、动画交互等核心功能。文章从需求分析、总体架构、核心模块设计、关键代码实现、界面设计、测试结果、项目总结等方面完整阐述，适合作为 C++ Qt 综合实训项目、课程设计参考。关键词：C++；Qt；欢乐斗地主；棋牌游戏；图形界面；牌型算法

基于 C++ 与 Qt 的欢乐斗地主游戏项目设计与实现

欢乐斗地主是国内流行的扑克棋牌类游戏，具备规则清晰、交互性强的特点。本文采用 C++ 作为底层业务逻辑开发语言，Qt 框架搭建图形界面，完成一款单机版欢乐斗地主系统。项目实现扑克牌生成、洗牌发牌、叫地主、抢地主、出牌校验、牌型识别、胜负判定、动画交互等核心功能。文章从需求分析、总体架构、核心模块设计、关键代码实现、界面设计、测试结果、项目总结等方面完整阐述，适合作为 C++ Qt 综合实训项目、课

编程语言

基于C++与Qt的欢乐斗地主系统，涵盖洗牌发牌、叫地主、牌型识别、出牌校验与AI对战。采用分层架构与状态机管理，实现完整单机对战流程。适合作为C++Qt课程设计参考，代码结构清晰，覆盖棋牌核心算法与图形界面交互。

数据建模

游戏开发

单元测试

代码解释

容器

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

基于 C++ 与 Qt 的欢乐斗地主游戏项目设计与实现-腾讯云开发者社区-腾讯云

基于 C++ 与 Qt 的欢乐斗地主游戏项目设计与实现

基于 C++ 与 Qt 的欢乐斗地主游戏项目设计与实现

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐