简介这份基于Qt与C开发的Flappy Bird游戏源码非常适合作为毕业设计、课程设计或Qt入门项目的参考实现。项目围绕经典小游戏完整展示了Qt游戏开发的基本思路利用定时器驱动画面刷新通过事件响应处理按键操作借助碰撞检测判定游戏状态并配有计分与音效反馈功能完整且易于理解。代码按模块拆分为界面、逻辑与资源三部分关键对象如小鸟、管道、背景滚动等均有对应类封装便于后续二次开发。整个压缩包共27个文件约3.38MB内含5个C源文件、4个头文件、8张界面素材图片、2首MP3和1个WAV音效以及工程配置、可执行程序和说明文档拿到后即可运行体验或导入Qt Creator继续调试扩展。截至目前已有188人学习下载对于想快速上手Qt游戏编程、或需要一份可演示工程项目的人来说是不错的选择。1. 基于QTC的flappyBird源码包课程设计能直接跑通的完整工程最近后台问 C 课程设计选题的人不少QT flappyBird 这个组合几乎绕不开。这个源码包不是那种只有一个主函数的 demo而是带完整资源、带碰撞检测、带计分循环的小工程。解压后用 Qt Creator 打开 flappyBird.pro编译就能跑图片和音效都打包在 qrc 资源文件里不需要额外配路径。适合两类人一是要做课程设计或毕业设计想交一个能演示、能讲清楚技术点的 GUI 项目的学生二是想练 Qt 2D 绘图、定时器机制和事件处理的开发者。下面我会按工程结构、核心类设计、游戏机制、踩坑记录、编译调试、二次开发的顺序过一遍每一段都落到代码和参数层面照着做就能复现。2. 工程结构与核心类设计从 pro 文件读懂整个游戏怎么组织2.1 flappyBird.pro 配置QT 模块、源文件注册与资源打包先看工程根目录下的 flappyBird.pro这个文件决定了整个项目怎么被 qmake 解析和编译。文件内容大致是这样的QT core gui greaterThan(QT_MAJOR_VERSION, 4): QT widgets TARGET flappyBird TEMPLATE app CONFIG c11 SOURCES main.cpp \ widget.cpp \ item.cpp \ roadItem.cpp \ pipeItem.cpp HEADERS widget.h \ item.h \ roadItem.h \ pipeItem.h RESOURCES src.qrc这里有个关键点greaterThan(QT_MAJOR_VERSION, 4): QT widgets。这是让工程同时兼容 Qt4 和 Qt5/Qt6 的常见写法从 Qt5 开始 QWidget 相关类被拆到了 widgets 模块不加这一行widget.h 会直接报找不到头文件。TARGET flappyBird决定生成的可执行文件名课程设计里通常保持和项目名一致。资源文件集中在 src.qrc 里图片和音效被打包进二进制运行时不需要担心素材路径丢失。qrc 文件的写法是 XML 格式前缀路径可以自定义引用时用:/前缀/文件名的方式获取。这个细节对后面替换素材很关键很多人改了图片但游戏里没变化大概率是 qrc 路径写错或者编译缓存没刷新第四章会专门说这个问题。2.2 三个实体类item、roadItem、pipeItem 的职责边界这个工程的对象模型很干净所有会移动的物体都抽象成 item 的子类。先看 item.h#ifndef ITEM_H #define ITEM_H #include QRectF class Item { public: Item(); virtual ~Item(); QRectF getRect() const { return rect; } void setRect(const QRectF r) { rect r; } // 子类必须实现自己的移动逻辑 virtual void move() 0; protected: QRectF rect; }; #endif // ITEM_H纯虚函数move()强迫 roadItem 和 pipeItem 各自实现移动方式这是用多态管理游戏对象的典型做法。roadItem 是路面负责无限滚动的背景效果pipeItem 是上下两根管道负责从左向右移动。两者的 move() 实现完全不同但 widget 里可以统一用基类指针调 move()。再看 roadItem.cpp 的核心移动逻辑void RoadItem::move() { // 每帧向左移动 speed 像素产生路面滚动的效果 rect.moveLeft(rect.left() - speed); // 如果路面已经完全滚出屏幕左侧把它重新放回右侧拼接 if (rect.right() 0) { rect.moveLeft(rect.left() totalWidth); } }这里的 speed 是每帧移动的像素数一般在 2 像素左右。路面由两张图左右拼接移动的距离要等于路面宽度否则会出现视觉断裂。我一般会先把 road.png 的实际像素宽度量出来再把移动循环周期设置成宽度的整数倍这样无限滚动的衔接才自然。pipeItem.cpp 的移动逻辑更简单就是单纯地左移void PipeItem::move() { rect.moveLeft(rect.left() - speed); }但管道对象有个额外职责记录上下管道之间的缺口位置这个缺口是玩家操作的空间宽度直接决定游戏难度。pipeItem 里通常维护两个 QRectF分别代表上管道和下管道缺口高度在 widget 生成管道时传入。2.3 widget.cpp定时器、状态机和事件入口widget 是整个游戏的主控类继承 QWidget既是窗口又是游戏循环的驱动者。构造函数里启动一个 QTimer每隔固定毫秒数触发一次更新timer new QTimer(this); connect(timer, QTimer::timeout, this, Widget::updateGame); timer-start(16); // 约 60 FPS16 毫秒对应大约 60 帧这是比较流畅的游戏循环频率。如果机器性能一般改成 20 毫秒也能跑但小鸟下落和管道移动的速度要相应调整否则游戏会明显变慢。这里的核心逻辑是Qt 的事件循环驱动定时器定时器驱动 updateGameupdateGame 里完成所有游戏对象的坐标更新、碰撞检测和界面重绘。updateGame 内部通常维护一个状态机常见的是三个状态准备中、运行中、游戏结束。我用枚举来管理enum GameState { Ready, Running, Dead };空格键第一次按下时从 Ready 切到 Running小鸟获得一个初始向上的速度碰撞发生时切到 Dead定时器停止画面定格。这个状态机是课程设计答辩时的高频考点建议重点讲清楚每个状态之间怎么转移。3. 游戏机制落地管道生成、碰撞检测与计分循环3.1 管道生成算法随机行高与固定间距的配合flappyBird 的核心难度来自管道的随机高度和固定水平间距。管道生成不是一次性铺满屏幕而是随着游戏推进不断在右侧生成新的管道对。生成逻辑写在 widget.cpp 里大致思路是void Widget::spawnPipe() { // 随机生成下管道顶部开口的位置范围限制在中段区域 int gapY QRandomGenerator::global()-bounded(80, 260); // 创建上管道和下管道缺口高度固定为 gapHeight PipeItem *topPipe new PipeItem(); topPipe-setRect(QRectF(startX, gapY - topPipeHeight, pipeWidth, topPipeHeight)); PipeItem *bottomPipe new PipeItem(); bottomPipe-setRect(QRectF(startX, gapY gapHeight, pipeWidth, sceneHeight - gapY - gapHeight)); }参数上有几个值需要调。gapHeight 是上下管道之间的缺口高度我测试下来 140 到 160 像素之间手感比较合适小于 120 就对新手极不友好。gapY 的随机范围要保证上下管道不会超出屏幕边界一般限制在屏幕高度中间 60% 的区域内。管道水平间距通常在 220 到 260 像素之间这个值决定了玩家连续操作的时间窗口。每次生成管道后用QElapsedTimer或简单记录上一根管道的位置保证间距均匀。常见做法是当最后一根管道右边缘进入屏幕一半时生成下一根。这种做法比纯时间间隔更可靠因为定时器在不同帧率下的表现会有微小差异。3.2 碰撞检测的判定方式矩形相交就足够了碰撞检测乍看像是个需要精细处理的问题但这个工程用的是最简单的 QRectF::intersects 矩形相交判定。小鸟的矩形和管道的矩形如果有重叠区域就判定死亡bool Widget::hitPipe() { // 只检测小鸟周围的管道不遍历全部对象 foreach (PipeItem *pipe, pipes) { QRectF birdRect bird-getRect(); if (birdRect.intersects(pipe-getTopRect()) || birdRect.intersects(pipe-getBottomRect())) { return true; } } return false; }这里有两个细节值得注意。第一小鸟的碰撞矩形通常比渲染出来的图片要小一圈比如图片是 34x26 像素碰撞矩形只取 28x20这样玩家会有轻微的安全余量手感更宽松。这个技巧在正经游戏开发里叫“碰撞盒收缩”能显著减少“明明没碰到却死了”的挫败感。第二只检测小鸟附近的管道不遍历全部管道虽然这个工程的管道数量不多但这个写法值得保留是讲性能意识的好素材。地面的碰撞检测单独处理一旦小鸟的底部超过路面的顶部直接判死不需要走矩形相交逻辑。这是最容易忽略的边界情况代码里必须有单独判断。3.3 计分循环通过管道一根加一分注意防止重复计分计分的实现思路很直接记录小鸟的 x 坐标当一根管道的右边缘越过小鸟的 x 坐标时分数加一。但如果不做标记同一根管道会在连续几帧内都满足这个条件导致一局游戏分数大幅虚高。对应的解决办法是给管道加一个“是否已经计过数”的标记void Widget::checkScore() { foreach (PipeItem *pipe, pipes) { // 只对未计分的管道做检测 if (!pipe-isScored() pipe-getRect().right() bird-getRect().left()) { pipe-setScored(true); score; // 分数变化后立即刷新界面 update(); } } }这里的逻辑判断顺序很关键先检查未计分再检查位置关系最后才加分和更新界面。update()触发 Qt 的油漆事件重绘整个窗口分数变化才会显示出来。如果漏掉这一步分数虽然在增加但玩家在屏幕上永远看不到变化这是课程设计现场演示最容易翻车的点。分数显示可以用 drawText 直接画在 widget 上也可以用一个 QLCDNumber 控件放在窗口顶部。源码里用的应该是 drawText写起来省事但视觉上比较简陋。我一般会建议从 QLCDNumber 切入做界面优化既不影响原有逻辑又能直观地让界面看起来更完整。4. 避坑记录QT 版本不匹配、中文路径、资源缓存与随机数陷阱4.1 现象编译时报 fatal: cannot mix incompatible qt library (version ex50601) with this librar这个报错常见于电脑里同时装了多个 Qt 版本。我遇到过的情况是默认 qmake 指向 Qt 5.14但 Qt Creator 的构建套件选的是 Qt 5.15结果 moc 生成的文件和链接库版本不一致直接报版本冲突。原因是 qmake 和编译器套件各自找到了不匹配的 Qt 库路径。解决方法是先跑一遍qmake -v确认当前命令行里的 qmake 版本再打开 Qt Creator 检查 Projects - Manage Kits 里选择的 Qt 版本是否和编译器匹配。如果还是报错就在构建目录里执行一次make clean和qmake强制重新生成 Makefile。注意同时把系统 PATH 里的 Qt 环境理顺只保留要用的那一条。4.2 现象程序编译通过但运行时提示 qt.qpa.plugin: could not find the qt platform plugin linuxfb这个坑在 Linux 环境特别常见。源码本身没有图形界面依赖问题但运行时 Qt 需要加载 platform plugin比如 xcb 或 linuxfbplugin 路径如果不在搜索范围内就会直接崩溃。原因是 Qt 运行时找不到 platforms 目录下的 .so 文件常见于只装了开发包没装运行库或者环境变量没设置。解决方法是先确认系统装了 xcb 相关依赖或者在 QT_QPA_PLATFORM_PLUGIN_PATH 环境变量里手动指定 platform 插件路径。开发调试阶段也可以临时用QT_QPA_PLATFORMoffscreen让程序以离线渲染方式跑起来先验证逻辑再回头处理显示问题。4.3 现象图片和音效加载失败但文件明明存在把整个工程放在带中文的路径下比如D:\课程设计\flappyBird很容易出现资源加载失败。Qt 在 Windows 下对非 ASCII 路径的处理有历史问题qrc 的相对路径解析也可能被影响导致图标显示成空白游戏画面残缺。解决方法是把工程目录整体移动到纯英文路径比如D:\project\flappyBird。另外注意 qrc 文件里引用的路径大小写要和实际文件名一致Linux 下大小写敏感Windows 下大小写不敏感两份环境的表现会不一样统一用小写命名文件名可以少踩这类坑。4.4 现象改了 qrc 里的资源文件重新编译运行后界面还是旧图这个问题的根源不是代码而是 qrc 的依赖跟踪不完整。某些场景下 Qt Creator 不会自动感知 qrc 文件里资源内容的变动导致链接进二进制的还是旧资源。解决办法是手动触发重新构建右键工程选择 Run qmake然后执行清理、重新编译。如果频繁改资源我一般会直接把资源文件内容改了之后同时修改文件名或路径强制 Makefile 感知变化。另外新加入的图片必须先在 qrc 编辑器里 Add Files只是把文件丢进目录但不注册到 qrc程序是读不到的。4.5 现象每次新开一局管道的随机顺序完全一样看到这个现象第一反应就是随机数没有随机化。Qt 早期版本用 qsrand 配合 qrand如果不在程序启动时播种qrand 每次产生的序列完全一致看起来就是“伪随机但每次都相同”。解决方法是启动时设置随机种子。Qt5 里可以用qsrand(QTime::currentTime().msec())Qt6 里 qsrand 已经废弃推荐用 QRandomGenerator// Qt5 写法 qsrand(QTime::currentTime().msec()); // Qt6 推荐写法 int gapY QRandomGenerator::global()-bounded(80, 260);特别提醒不要在构造函数和 spawnPipe 里反复调用带时间种的 qsrand因为两次调用间隔太短可能生成相同种子反而让随机失效。播种只需要一次生成随机值的接口可以被反复调用。5. 在 Qt Creator 里跑通并调试构建套件选择、qDebug 定位与断点排错5.1 用 Qt Creator 打开 pro 文件而不是逐个添加源码文件拿到源码包后最省事的方式不是新建工程再手动添加文件而是直接用 Qt Creator 的 Open Project 选中 flappyBird.pro。qmake 会根据 pro 文件里的 SOURCES 和 HEADERS 自动加载所有源文件文件结构一目了然。打开后第一件事是确认构建套件。新手经常栽在 Kit 选择上装了 MinGW 版本的 Qt却在构建套件里选了 MSVC 编译器结果编译器找不到。我建议学这个项目时优先用 MinGW 64 位套件配好后基本一路编译通过。如果提示 No suitable kits多半是安装 Qt 时没勾选对应的编译器组件需要回到 Qt 安装工具里补装。5.2 qDebug 打印坐标碰撞检测不触发时怎么定位游戏逻辑有个常见问题小鸟明明穿过了管道却没有触发碰撞。这种情况靠肉眼很难看出原因最直接的办法是在 updateGame 里加一行 qDebugqDebug() bird: birdRect.left() birdRect.top() pipe: pipe-getTopRect().left() pipe-getTopRect().top();运行后在输出栏能看到每帧小鸟和管道的坐标。重点观察两个值一是管道移动速度是否正常二是小鸟的下落加速度是否符合预期。我遇到的多数情况是定时器真的在跑但管道的坐标更新写错了对象导致画面上的管道位置和内存里的矩形位置不一致。另一个高频问题是碰撞检测写在分数检测后面管道右边缘越过小鸟后下一帧管道已经离开碰撞区域矩形不再相交碰撞就永远发生在两帧之间。解决办法是把碰撞检测和计分检测的顺序固定为先移动对象再检测碰撞最后判断分数。5.3 纯代码绘制 vs Qt Designer 界面这个工程为什么坚持用 QPainter这个源码包没有 .ui 文件全部界面靠 widget 的 paintEvent 手绘。网上不少资料推荐把界面拖到 Qt Designer 里但游戏这种高频重绘的场景用 UI 控件反而别扭。QPainter 绘制的好处是每帧都能精确控制画面配合定时器重绘逻辑上非常顺畅。void Widget::paintEvent(QPaintEvent *event) { QPainter painter(this); // 绘制背景、路面、管道和小鸟 painter.drawImage(backgroundRect, backgroundImg); foreach (PipeItem *pipe, pipes) { painter.drawImage(pipe-getTopRect(), pipeImg); painter.drawImage(pipe-getBottomRect(), pipeImg); } painter.drawImage(birdRect, birdImg); }如果第一次接触 QPainter 的坐标系统有个概念必须搞清楚窗口坐标系的原点在左上角x 轴向右增长y 轴向下增长。所以“小鸟下落”在代码里表现为 y 坐标逐渐增大而不是减小。很多人读代码时习惯数学坐标系一看到 y 变大以为是往上飞这是理解误区答辩时尤其容易被老师问到。调 qreal 类型的坐标精度时QRectF 比 QRect 更合适因为移动速度可能带小数QRect 的 int 坐标会直接丢弃小数部分时间久了会出现位置偏移。工程里用 QRectF 的做法是对的等我二次开发替换图片素材时也保留这个选择。6. 二次开发扩展方向从复现到改造成自己的课程设计这章聊聊拿到源码后怎么扩展成自己的项目。最快速的改造是加一个计分显示控件把 drawText 换成 QLCDNumber数字会更清晰看起来也更接近手机游戏。代码改动不大在 widget.h 里加一个QLCDNumber *scoreDisplay;构造函数里 new 出来并设置位置然后把原来更新 score 的地方同步调scoreDisplay-display(score)。第二个推荐的功能是永久最高分存档。用 QSettings 写注册表或者配置文件把历史最高分保存下来每次游戏结束后判断是否刷新纪录。这是给课程设计加亮点的低成本做法也方便在答辩时展示数据持久化的能力。素材替换是最常被问到的需求。替换小鸟图片时注意用带透明通道的 PNG不要用 JPG。透明背景的 PNG 画到 QPainter 上是干净的透明效果JPG 会有白色底框一眼看去就是一个白方块在飞。管道图片的高度要按实际像素设置如果图片是 60x400QRectF 的高度就设 400靠拉伸图片会导致管道比例变形游戏难度也跟着变。发布可执行文件时用 windeployqt 命令自动收集运行所需的 DLL 和 platforms 目录Windows 下最常见的“缺 DLL 跑不起来”问题就出在这个环节。我一开始做 Qt 项目时也不懂这个环节直接把 exe 拷给别人结果对方一运行就报 Qt5Core 找不到。从那以后每次交付 exe我都会强制走一遍 windeployqt 再把整个输出目录打包多花两分钟少丢一次人。做课程设计时不要过度设计这个工程最合适的改造量是保证有原样可跑的部分再加上一个能讲清楚的技术点比如暂停功能或者最高分持久化。把握住这个分寸顺手把原来工程里的几处坑修复掉答辩时能说清楚的地方就足够多了。希望帮到你。本文还有配套的精品资源点击获取