简介本资源是南京大学计算机科学与技术系高级程序设计课程的大作业源码基于C与Qt图形库实现了一款类幸存者游戏面向正在学习面向对象编程、希望借助完整项目练手的高校学生与C初学者。项目并非追求完美的成品游戏而是以实践OOP设计模式为核心目标涵盖基本地图与障碍物、玩家角色移动攻击掉血拾取、敌方单位移动与攻击策略、局内与全局强化系统、存档读档以及可流畅运行的UI界面等模块结构完整、层次清晰。压缩包共80个文件约2.29MB其中53个png与2个gif构成角色、敌人、子弹、背景等美术素材9个cpp与9个h承载核心逻辑另有2个ui界面文件、qrc资源文件、pro工程文件及README说明便于在Qt 5.15.2及以上版本配合Qt Creator直接打开编译。目前已有79人浏览学习适合作为课程设计参考、Qt入门实战或面向对象重构练习的完整案例。1. 从一份 Qt 幸存者游戏源码说起它到底能跑出什么很多人拿到「基于 Qt 框架的幸存者游戏.zip」这类源码包第一反应是解压、找 .pro、双击打开、点运行然后卡在编译报错或者黑屏闪退上。幸存者游戏Survivor-like的核心循环其实不复杂角色自动攻击、敌人成波刷新、经验拾取、升级选词条、时间推进难度。用 Qt 做这件事意味着你不用碰 Unity 或 Godot直接用 C 和 Qt 的图形视图框架、定时器、事件系统把整套玩法搭出来。它适合两类人一是想学 Qt 桌面开发但不想只写计算器的 C 新手二是想找一个完整可拆解的游戏循环来练架构的熟手。源码包里通常包含 .pro 工程文件、main.cpp、游戏主场景类、实体基类、资源目录和若干 UI 文件。能不能直接跑起来取决于你的 Qt 版本、编译器套件和资源路径是否对得上。下面按「先跑通、再拆解、后改造」的顺序把这份源码的落地路径讲清楚。2. 把工程跑起来Qt 版本、编译套件与资源路径的三重对齐2.1 先确认你装的是哪套 Qt别拿 Qt6 硬开 Qt5 工程Qt 的版本差异在游戏类工程里会被放大。Qt5 的QGraphicsView、QTimer、QMediaPlayer和 Qt6 的对应模块在头文件路径、信号槽语法、多媒体后端上都有区别。常见做法是先看 .pro 文件里的QT 行如果写的是QT core gui widgets multimedia大概率是 Qt5 工程如果出现QT core5compat或者find_package(Qt6 ...)那是 Qt6。热搜里常出现的 qt 5.15.2 下载安装、qt 下载、qt 安装本质上都是在解决「版本对不上」这个第一道坎。我一般会这样确认环境# 查看已安装的 Qt 版本Linux/macOS qmake -v # 或者 qmake6 -v # Windows 下在 Qt Creator 的 Kits 页面看 # Tools - Options - Kits - Qt Versions如果qmake -v输出的是 Qt 5.15.x而工程 .pro 里写的是greaterThan(QT_MAJOR_VERSION, 5)的条件分支那就要注意条件编译块是否覆盖了你的版本。参数说明QT_MAJOR_VERSION是 qmake 内置变量值为 5 或 6greaterThan是 qmake 的条件函数用来做版本分支。失败时先看编译输出第一行用的是哪个 qmake很多人机器上装了三个 QtQt Creator 默认选中的未必是你以为的那个。2.2 编译套件选 MinGW 还是 MSVC决定你能不能一键运行Windows 上 Qt 官方安装器会同时提供 MinGW 和 MSVC 两套套件。MinGW 开箱即用MSVC 需要额外装 Visual Studio Build Tools。热搜里「qt 按照完 mingw 编译器后怎么安装 msvc 编译工具链」就是这个问题。对于幸存者游戏这种纯 Qt 工程MinGW 足够但如果源码里用了 Windows API 或者第三方 .libMSVC 更稳。在 Qt Creator 里的操作路径打开工程后左侧点击「Projects」。在「Build Run」里选一个 Kit确认 Qt version 和 Compiler 都是可用状态没有红色感叹号。如果 Kit 显示不可用点「Manage Kits」在 Compiler 里手动添加 MinGW 的 g.exe 路径通常在Qt/Tools/mingw*/bin下。回到 Build 设置把 Shadow build 目录设成一个短路径比如D:/build-survivor避免中文路径和空格。参数说明Shadow build 是影子构建源码目录和构建目录分离好处是清理方便短路径是为了绕开 Windows 上 260 字符路径限制Qt 的 moc 生成文件路径一长就容易报cannot find -lpublic这类找不到库的错。失败时看 Compile Output 里第一条 error如果是:-1: error: unknown module(s) in qt: webenginewidgets说明工程依赖了 Qt WebEngine而你的套件里没装这个模块要么装模块要么在 .pro 里注释掉相关行。2.3 资源路径与工作目录为什么你双击 exe 就黑屏Qt 工程里资源通常走.qrc文件编译时被打进可执行文件。但游戏如果用了外部图片、音频、地图文件代码里往往写的是相对路径比如QPixmap(assets/player.png)。在 Qt Creator 里点运行工作目录默认是构建目录Qt Creator 会帮你把工作目录设对但你直接去 build 文件夹双击 exe工作目录变成 exe 所在目录相对路径就找不到了表现就是黑屏或者角色不显示。解决办法有两个一是把所有资源都放进 .qrc用:/assets/player.png这种冒号前缀访问二是在 main.cpp 里手动设置工作目录#include QCoreApplication #include QDir int main(int argc, char *argv[]) { QCoreApplication::setAttribute(Qt::AA_UseOpenGLES); // 部分嵌入式设备需要 QApplication app(argc, argv); // 把工作目录切到可执行文件所在目录保证相对路径资源能找到 QDir::setCurrent(QCoreApplication::applicationDirPath()); MainWindow w; w.show(); return app.exec(); }逻辑说明applicationDirPath()返回 exe 所在绝对路径QDir::setCurrent把它设为当前工作目录。参数说明Qt::AA_UseOpenGLES是给 OpenGL 驱动不完整的设备用的桌面端一般不需要加了反而可能降低渲染性能。失败时看程序输出有没有QIODevice::read: No such file or directory有就是路径问题。3. 拆解幸存者游戏的核心循环定时器、实体管理与碰撞检测3.1 用 QTimer 驱动游戏主循环别在 paintEvent 里做逻辑幸存者游戏的节奏靠时间推进每帧移动、每隔几秒刷怪、攻击冷却倒计时。Qt 里最直接的做法是用QTimer以 16ms 间隔触发update()然后在paintEvent里画。但逻辑更新和渲染要分开否则帧率一波动游戏速度就跟着变。常见做法是维护一个QTimer做逻辑 tick另一个交给 Qt 的绘图系统// GameScene.h class GameScene : public QGraphicsScene { Q_OBJECT public: explicit GameScene(QObject *parent nullptr); protected: void timerEvent(QTimerEvent *event) override; private: int m_logicTimerId; qint64 m_lastTickMs; void updateGame(qreal deltaSeconds); }; // GameScene.cpp GameScene::GameScene(QObject *parent) : QGraphicsScene(parent) { m_lastTickMs QDateTime::currentMSecsSinceEpoch(); m_logicTimerId startTimer(16); // 约 60 FPS } void GameScene::timerEvent(QTimerEvent *event) { if (event-timerId() m_logicTimerId) { qint64 now QDateTime::currentMSecsSinceEpoch(); qreal delta (now - m_lastTickMs) / 1000.0; m_lastTickMs now; updateGame(delta); } }逻辑说明startTimer返回定时器 IDtimerEvent里按 ID 区分。delta是距上一帧的秒数所有移动和冷却都乘这个值保证不同帧率下速度一致。参数说明16ms 对应约 62.5 FPS是桌面端常用值如果设备性能弱可以改成 33ms30 FPS但 delta 机制保证玩法速度不变。失败时如果游戏一卡一卡先看updateGame里有没有耗时操作比如每帧遍历所有敌人做 O(n²) 碰撞。3.2 实体基类与对象池为什么你的敌人越刷越卡幸存者游戏后期屏幕上可能有几百个敌人和子弹。如果每次刷怪都new一个对象、死亡就delete内存碎片和构造析构开销会让帧率掉得厉害。常见做法是抽一个Entity基类用对象池复用。// Entity.h class Entity : public QGraphicsItem { public: enum Type { Player, Enemy, Bullet, Pickup }; explicit Entity(Type t, QGraphicsItem *parent nullptr); virtual void update(qreal delta) 0; bool isActive() const { return m_active; } void setActive(bool a) { m_active a; setVisible(a); } protected: Type m_type; bool m_active true; QPointF m_velocity; }; // EntityPool.h templatetypename T class EntityPool { public: T* acquire() { for (auto *e : m_pool) { if (!e-isActive()) { e-setActive(true); return e; } } T *e new T(); m_pool.append(e); return e; } void release(T *e) { e-setActive(false); } private: QVectorT* m_pool; };逻辑说明acquire先找池子里不活跃的对象复用找不到才新建。release不删除只标记不活跃并隐藏。参数说明QVector在 Qt5 里是隐式共享的遍历时注意不要边遍历边增删setVisible(false)比removeItem轻量适合频繁复用。失败时如果对象池越用越大检查是不是只 acquire 不 release或者 release 条件写错了。3.3 碰撞检测QGraphicsScene 自带的 collidingItems 够不够用Qt 的QGraphicsScene提供了collidingItems(item)返回与指定 item 相交的所有 item。对于几百个对象的规模它内部用的是 BSP 树比手写双重循环快。但要注意它返回的是QListQGraphicsItem*每次调用都会分配内存如果每帧对每个子弹都调一次开销也不小。我一般会做两层过滤先用距离做粗筛再对近邻调collidingItems。void GameScene::checkBulletHits() { const qreal hitRadius 24.0; for (auto *bullet : m_bullets) { if (!bullet-isActive()) continue; QListQGraphicsItem* hits bullet-collidingItems(); for (auto *hit : hits) { auto *entity dynamic_castEntity*(hit); if (!entity || entity-type() ! Entity::Enemy) continue; qreal dist QLineF(bullet-pos(), entity-pos()).length(); if (dist hitRadius) { entity-takeDamage(10); bullet-setActive(false); break; } } } }逻辑说明collidingItems返回包围盒相交的对象再用QLineF算实际距离避免圆形碰撞被方形包围盒误判。参数说明hitRadius是子弹命中半径单位是场景坐标像素根据你的角色和敌人尺寸调takeDamage(10)是伤害值升级系统里可以改。失败时如果子弹穿墙或者打不中先看boundingRect有没有正确重写QGraphicsItem 默认包围盒是 (0,0,0,0)不重写就永远不相交。4. 升级系统与 UI 联动QML 还是 QWidget怎么选不返工4.1 QWidget 做游戏 HUD 的三种布局方式幸存者游戏的 HUD 包括血条、经验条、计时器、升级弹窗。用 QWidget 做常见三种方式一是直接在主窗口上叠QLabel和QProgressBar二是用QGraphicsView的drawForeground在场景上层画三是单独做一个QWidget覆盖层用QStackedLayout切换。第一种最直观但控件多了之后布局管理会打架尤其是全屏和窗口化切换时。第二种性能好但文字排版和按钮交互要自己处理。第三种适合升级弹窗这种模态界面。// 用 QGraphicsView 的 drawForeground 画 HUD void GameView::drawForeground(QPainter *painter, const QRectF rect) { Q_UNUSED(rect); painter-setRenderHint(QPainter::Antialiasing); // 血条 QRectF hpBar(20, 20, 200, 18); painter-setPen(Qt::NoPen); painter-setBrush(Qt::darkGray); painter-drawRect(hpBar); painter-setBrush(Qt::red); painter-drawRect(QRectF(hpBar.topLeft(), QSizeF(hpBar.width() * m_player-hpRatio(), hpBar.height()))); // 计时器 painter-setPen(Qt::white); painter-setFont(QFont(Arial, 16)); painter-drawText(QPointF(20, 70), QString(Time: %1).arg(m_elapsedSeconds)); }逻辑说明drawForeground在场景所有 item 之后绘制适合做 HUD。hpRatio()返回 0.0 到 1.0 的血量比例。参数说明QFont(Arial, 16)里的 16 是点大小不是像素drawText的坐标是场景坐标如果视图缩放了HUD 也会跟着缩放所以要么把视图变换重置要么用QGraphicsView::setTransform单独处理。失败时如果 HUD 跟着地图滚动检查是不是把 HUD 加成了场景 item应该用 foreground 绘制。4.2 升级选词条用 QDialog 还是 QML Popup升级弹窗需要暂停游戏、展示三个随机词条、等玩家点击后恢复。用 QDialog 做模态阻塞简单直接用 QML 做动画和触摸体验更好。热搜里 qt qml、qt mvvm 框架这些词说明不少人在纠结要不要上 QML。我的判断标准如果目标平台是桌面键鼠QWidget QDialog 足够代码量少调试方便如果目标平台有触摸屏或者需要流畅的卡片动画QML 更合适。但 QML 和 C 的交互需要注册类型或者用QQuickView对新手来说多一层心智负担。// 用 QDialog 做升级弹窗 void GameScene::showLevelUpDialog() { QDialog dlg; dlg.setWindowTitle(Level Up); QVBoxLayout *layout new QVBoxLayout(dlg); QStringList upgrades {10% Move Speed, 15% Attack Damage, 20 Max HP}; for (const QString text : upgrades) { QPushButton *btn new QPushButton(text, dlg); connect(btn, QPushButton::clicked, [, text]() { applyUpgrade(text); dlg.accept(); }); layout-addWidget(btn); } // 暂停逻辑定时器 killTimer(m_logicTimerId); dlg.exec(); // 恢复 m_lastTickMs QDateTime::currentMSecsSinceEpoch(); m_logicTimerId startTimer(16); }逻辑说明dlg.exec()是模态阻塞会开一个局部事件循环游戏逻辑定时器被 kill 掉画面静止。applyUpgrade根据选择的文本改玩家属性。参数说明killTimer和startTimer成对出现恢复时重置m_lastTickMs否则 delta 会算成弹窗停留的几秒角色瞬移。失败时如果弹窗关不掉或者游戏卡死检查是不是在exec()里又开了定时器或者做了阻塞操作。4.3 信号槽跨线程刷怪和渲染别放同一个线程如果敌人 AI 或者寻路计算量大可以放到QThread里算完通过信号槽通知主线程更新。但 QGraphicsItem 不是线程安全的所有对场景的修改必须在主线程。// Worker 线程里算完位置发信号 class SpawnWorker : public QObject { Q_OBJECT public slots: void doSpawn() { QVectorQPointF positions; // ... 计算刷怪位置 emit spawnReady(positions); } signals: void spawnReady(const QVectorQPointF positions); }; // 主线程连接 connect(worker, SpawnWorker::spawnReady, this, GameScene::onSpawnReady, Qt::QueuedConnection);逻辑说明Qt::QueuedConnection保证槽函数在接收者线程执行跨线程必须用这个。参数说明QVectorQPointF作为信号参数需要注册元类型QPointF和QVector在 Qt5 里已经注册过自定义结构体要qRegisterMetaType。失败时如果槽函数没执行看 connect 返回值或者用QMetaObject::invokeMethod排查线程归属。5. 避坑与排查源码跑不通时先看这五条5.1 现象编译报cannot find -lpublic或unknown module(s) in qt: webenginewidgets原因.pro里QT 了当前套件没装的模块或者库路径里有中文/空格导致链接器解析失败。-lpublic这种通常是某个第三方库名字被截断实际是-lpublicxxx路径里有空格导致 qmake 拆错了。解决打开 .pro把QT webenginewidgets注释掉看代码里是否真的用了QWebEngineView如果用了去 Qt 维护工具里勾选对应模块重装。路径问题就把工程挪到纯英文无空格目录重新 qmake。5.2 现象程序启动就闪退报qt.qpa.plugin: could not find the Qt platform plugin linuxfb原因在嵌入式设备或者无桌面环境里跑Qt 找不到平台插件。linuxfb是帧缓冲插件桌面环境应该用xcb或windows。解决设置环境变量export QT_QPA_PLATFORMlinuxfb嵌入式或xcbLinux 桌面。如果插件确实缺失去 Qt 安装目录的plugins/platforms下确认有没有对应 .so没有就重装 Qt 对应组件。5.3 现象游戏能跑但角色不动或者移动速度跟帧率有关原因逻辑更新没有乘 delta或者QTimer间隔和paintEvent不同步。常见错误是在paintEvent里直接pos speed帧率越高移动越快。解决把所有位移改成pos velocity * deltadelta 从定时器里算。检查timerEvent里有没有正确计算(now - lastTick) / 1000.0单位是秒。5.4 现象升级弹窗关掉后敌人瞬间移动一大段原因弹窗期间逻辑定时器被 kill但m_lastTickMs没重置恢复后第一帧 delta 是弹窗停留的秒数所有实体按这个 delta 移动。解决在dlg.exec()返回后、startTimer之前把m_lastTickMs QDateTime::currentMSecsSinceEpoch()。或者更稳的做法是不 kill 定时器用一个m_paused标志在updateGame开头判断暂停时直接 return。5.5 现象发布 exe 到别的电脑提示缺少 Qt5Core.dll原因动态链接的 Qt 库没有随 exe 一起发布。Qt Creator 里运行用的是开发环境的库路径换机器就找不到。解决用windeployqt工具自动拷贝依赖。命令windeployqt --release --no-translations your_game.exe参数说明--release对应 release 构建--no-translations跳过翻译文件减小体积。执行完会在 exe 同目录生成platforms、imageformats等文件夹。失败时如果还缺 dll用 Dependency Walker 或者dumpbin /dependents看还依赖什么。6. 从能跑到能改给幸存者游戏加一套数据驱动的升级配置源码能跑通之后真正有价值的是把它改成你自己的玩法。幸存者游戏最值得改的是升级词条系统因为它是数据驱动的改起来不碰核心循环。我一般会把词条从硬编码的QStringList抽成 JSON 配置运行时加载这样策划改数值不用重新编译。// upgrades.json { upgrades: [ {id: speed_1, name: 10% Move Speed, stat: moveSpeed, mult: 1.1}, {id: damage_1, name: 15% Attack Damage, stat: attackDamage, mult: 1.15}, {id: hp_1, name: 20 Max HP, stat: maxHp, add: 20} ] }// 加载配置 QVectorUpgrade loadUpgrades(const QString path) { QFile file(path); if (!file.open(QIODevice::ReadOnly)) { qWarning() Cannot open path; return {}; } QJsonDocument doc QJsonDocument::fromJson(file.readAll()); QVectorUpgrade result; for (const QJsonValue v : doc.object()[upgrades].toArray()) { QJsonObject obj v.toObject(); Upgrade u; u.id obj[id].toString(); u.name obj[name].toString(); u.stat obj[stat].toString(); u.mult obj.contains(mult) ? obj[mult].toDouble() : 1.0; u.add obj.contains(add) ? obj[add].toInt() : 0; result.append(u); } return result; }逻辑说明QJsonDocument::fromJson解析 JSON遍历数组构造Upgrade结构体。mult和add二选一乘法用于百分比加成加法用于固定值。参数说明path建议用QCoreApplication::applicationDirPath() /upgrades.json发布时把 json 放在 exe 旁边。失败时如果解析出来是空先看doc.isObject()和doc.object().contains(upgrades)JSON 格式错误fromJson会返回 null 文档。改完配置后验证方法是把moveSpeed的 mult 改成 2.0进游戏看角色是不是明显变快再把 json 故意写错一个逗号看程序有没有输出警告而不是崩溃。这个习惯能帮你把「玄学 bug」变成可定位的配置问题。我自己踩过最深的坑是早期把升级逻辑写死在switch里后来想加一个新词条要改五处代码还漏了一处导致选完没效果。从那以后凡是数值相关的都走配置代码只负责读和算。希望帮到你。本文还有配套的精品资源点击获取
