简介这份资源是基于Qt C框架实现的简易植物大战僵尸游戏源码面向具备一定C基础、希望借助完整小项目理解Qt图形界面开发与游戏逻辑的开发者与学习者。压缩包共36个文件以17个cpp源文件与16个h头文件为主体另含1个pro工程文件、1个qrc资源文件及1个user配置整体约33KB结构紧凑便于通读。源码覆盖植物种植、僵尸移动与攻击、阳光收集、冷却卡片、小推车等核心模块并借助信号与槽机制处理点击、定时等事件通过QGraphicsView与定时器实现动画刷新同时涉及多线程与模块化类设计等实践要点。目前已有198人学习下载适合作为Qt入门练手、课程设计参考或二次开发起点帮助读者快速掌握Qt Widgets界面搭建、事件驱动编程与C面向对象在游戏场景中的落地方式。1. 一份能跑起来的 Qt C 植物大战僵尸源码到底值不值得拆很多人第一次搜「Qt C 小游戏」的时候心里想的其实不是学 Qt而是想找一个能编译、能跑、代码结构还看得懂的完整项目。这份PlantsVsZombies-main就是干这个的一个用 Qt Widgets 加 C 手写的简易植物大战僵尸带PVZ.pro工程文件、res.qrc资源文件以及一整套按角色拆分的类。它解决的不是「教你 C 语法」而是「给你一个能落地的 GUI 游戏骨架」——植物卡片、阳光、冷却、僵尸波次、子弹碰撞、小推车这些模块都在适合想拿 Qt 做课程设计、想练信号槽和定时器、或者想改一个能玩的小游戏的人。源码里没有网络模块也没有复杂引擎纯 Qt 事件循环加 QPainter 绘制对新手友好对熟手也能当模板改。2. 先看清工程结构PVZ.pro 里到底装了什么2.1 从文件清单反推模块划分拿到一个.zip源码包我一般不会先打开main.cpp而是先看文件命名。这份源码的命名很直白基本是按「实体 行为」拆的文件作用main.cpp/mainwidget.h/.cpp程序入口和主窗口游戏主循环大概率挂在这里gamemap.h/.cpp地图网格负责行列坐标和种植位置判定plants.h/.cpp/peas.h/.cpp植物基类与豌豆射手攻击逻辑zombie.h/.cpp/zombies.h/.cpp僵尸单体与僵尸管理sunshine.h/.cpp/sumshine.h/.cpp阳光掉落与收集plantscard.h/.cpp/setplants.h/.cpp植物卡片与种植操作cooldowndark.h/.cpp卡片冷却遮罩shootbox.h/.cpp子弹容器smallcar.h/.cpp小推车spade.h/.cpp铲子gamemedia.h/.cpp音效或媒体加载plantthread.h/.cpp线程相关可能是僵尸移动或阳光生成res.qrc图片、音频资源索引这种拆法说明作者是按「一个角色一个类」来写的不是把所有逻辑塞进mainwidget。对想学 Qt 的人来说这比那种几千行单文件的 demo 有价值得多因为你能看到类之间怎么通过信号槽和容器通信。2.2 用 Qt Creator 打开并确认构建套件第一步不是改代码是确认工程能识别。把 zip 解压到一个纯英文路径下路径里不要有中文和空格这是 Qt 工程的老规矩。然后用 Qt Creator 打开PVZ.pro。# 解压后目录大概长这样 PlantsVsZombies-main/ ├── PVZ.pro ├── PVZ.pro.user ├── main.cpp ├── mainwidget.cpp ├── mainwidget.h ├── res.qrc └── ... 其余 .cpp/.h打开后 Qt Creator 会让你选 Kit。如果你装的是 Qt 5.15.2 或 Qt 6.x选对应的 Desktop Kit。PVZ.pro.user是作者本机的配置换机器后里面的路径会失效Qt Creator 通常会提示重新配置直接让它重建即可不要手动去改这个文件。提示如果打开后左侧项目树是灰的或者提示Cannot find file: PVZ.pro多半是解压路径带中文换个盘符根目录再试。2.3 读懂 .pro 文件里的模块依赖.pro是 qmake 的工程描述文件决定了链接哪些 Qt 模块。这份游戏是纯 Widgets 加绘图常见配置是QT core gui widgets TARGET PVZ TEMPLATE app SOURCES main.cpp \ mainwidget.cpp \ gamemap.cpp \ plants.cpp \ peas.cpp \ zombie.cpp \ zombies.cpp \ sunshine.cpp \ plantscard.cpp \ setplants.cpp \ cooldowndark.cpp \ shootbox.cpp \ smallcar.cpp \ spade.cpp \ gamemedia.cpp \ plantthread.cpp HEADERS mainwidget.h \ gamemap.h \ plants.h \ peas.h \ zombie.h \ zombies.h \ sunshine.h \ plantscard.h \ setplants.h \ cooldowndark.h \ shootbox.h \ smallcar.h \ spade.h \ gamemedia.h \ plantthread.h RESOURCES res.qrcQT widgets是必须的因为界面用的是 QWidget 体系。RESOURCES res.qrc把图片和音频编进可执行文件所以运行时不需要额外拷贝素材目录。如果你后面要加新图片得先把文件加进res.qrc再在代码里用:/前缀引用否则运行时会找不到资源。3. 编译跑通从 qmake 到第一次看到草坪3.1 命令行构建与常见报错定位不想开 Qt Creator 的话命令行也能构建。前提是 qmake 和编译器已经在 PATH 里。# 在工程目录下执行 qmake PVZ.pro make # Linux / macOS # 或者 Windows MinGW mingw32-make构建过程中最容易翻车的地方有三个。第一是cannot find -lpublic这类链接错误通常是.pro里多写了不存在的库或者 Qt 版本和 Kit 不匹配。第二是fatal: cannot mix incompatible Qt library说明你系统里存在多个 Qt 版本运行时加载了和编译时不一致的库解决办法是清理构建目录重新 qmake并确认 Kit 唯一。第三是qt.qpa.plugin: could not find the qt platform plugin这是运行期找不到平台插件Linux 下常见于没装libqt5gui5之类的运行库或者QT_QPA_PLATFORM_PLUGIN_PATH被污染。# 清理后重建解决大部分版本混用问题 make clean qmake PVZ.pro make3.2 资源加载与 QPainter 绘制路径游戏画面不是用 QGraphicsView 做的从文件结构看更像是直接在mainwidget的paintEvent里用 QPainter 画。这种做法的好处是可控坏处是所有坐标都得自己算。资源通过res.qrc引入后代码里一般这样取图// 从资源文件加载图片:/ 前缀对应 res.qrc 里的别名 QPixmap pixmap(:/images/plants/peashooter.png); if (pixmap.isNull()) { qDebug() 资源加载失败检查 res.qrc 路径; }:/是 Qt 资源系统的固定前缀后面跟的是你在.qrc里写的路径。如果图片显示不出来先确认.qrc里有没有这一项再确认文件名大小写是否一致——Linux 下大小写敏感Windows 下不敏感这也是同一份代码换系统后「玄学」失效的常见原因。3.3 主循环与定时器驱动Qt 游戏不用手写while(true)而是靠QTimer驱动帧更新。主窗口里通常会有这么一段// 游戏主定时器约 30ms 触发一次对应 30 帧左右 QTimer *gameTimer new QTimer(this); connect(gameTimer, QTimer::timeout, this, MainWidget::updateGame); gameTimer-start(30);start(30)里的 30 是毫秒数值越小刷新越快但 CPU 占用也越高。僵尸移动、子弹飞行、阳光掉落、冷却倒计时都挂在这个updateGame里。如果你觉得游戏「一顿一顿」先看这个值是不是被改大了如果 CPU 飙高就适当调大。plantthread的存在说明部分逻辑可能放到了独立线程但 Qt 里跨线程更新 UI 必须用信号槽不能直接调paintEvent否则会崩。4. 核心玩法模块怎么改植物、僵尸与碰撞4.1 植物种植与网格坐标换算种植的核心是把鼠标点击的像素坐标转成地图行列。gamemap大概率提供了类似getRowCol(x, y)的方法。典型实现是// 把屏幕坐标换算成网格行列gridSize 是每格像素 int col (mouseX - mapOffsetX) / gridSize; int row (mouseY - mapOffsetY) / gridSize; if (row 0 row ROWS col 0 col COLS) { // 该格可种植 }mapOffsetX/Y是草坪左上角在窗口里的偏移gridSize是单格边长。这两个值一旦和背景图对不上就会出现「点下去种歪了」的现象。改背景图尺寸后必须同步改这两个参数否则种植位置全乱。这是新手改素材时最常踩的坑。4.2 僵尸移动与波次生成僵尸的移动一般是在zombie.cpp里维护一个x坐标每次定时器触发就减去速度值。波次生成则在zombies.cpp里用计数器或计时器控制。// 僵尸每帧左移speed 越大越难 void Zombie::move() { x - speed; if (x 0) { // 到达最左侧触发失败或小推车 } }想调难度改speed和生成间隔就行。但要注意僵尸数量多的时候如果每帧都做碰撞检测复杂度是 O(n*m)卡顿就来了。常见优化是只检测同一行内的僵尸和子弹因为植物大战僵尸本质是行内对抗跨行碰撞没有意义。4.3 子弹与碰撞判定豌豆子弹在peas.cpp碰撞通常用矩形相交// 子弹与僵尸的矩形碰撞检测 QRect peaRect pea-rect(); QRect zombieRect zombie-rect(); if (peaRect.intersects(zombieRect)) { zombie-takeDamage(damage); pea-setAlive(false); }intersects是 Qt 自带的矩形相交判断比自己写坐标比较省事。这里的关键参数是子弹的damage和僵尸的hp。如果你发现子弹穿过了僵尸却没伤害多半是两者的坐标系不一致——一个用的是场景坐标一个用的是控件坐标得统一到同一套坐标里再比。4.4 阳光、冷却与卡片状态阳光系统分两块掉落和收集。sunshine.cpp负责生成可点击的阳光sumshine.cpp可能是阳光数值管理。卡片冷却在cooldowndark.cpp用一张半透明遮罩盖在卡片上冷却时间到了再隐藏。// 卡片冷却用定时器递减剩余冷却时间 void PlantsCard::updateCooldown() { if (cooldownRemain 0) { cooldownRemain - 30; // 与主定时器间隔一致 darkOverlay-setGeometry(...); // 根据剩余比例调整遮罩高度 } else { darkOverlay-hide(); } }cooldownRemain的递减步长必须和主定时器间隔一致否则冷却时间会对不上。主定时器是 30ms这里就减 30如果主定时器改成 50ms这里也得改不然卡片冷却会变快或变慢。这种「两处参数必须同步」的地方是改代码时最容易漏的。5. 避坑与排查编译、运行、改素材时最容易翻车的地方5.1 现象编译通过但运行闪退原因资源路径错误或空指针。res.qrc里引用的图片实际不存在QPixmap加载为 null后续绘制时对空对象操作。解决在加载资源后加isNull()判断先把所有资源路径打印一遍确认每个文件都能找到。5.2 现象换电脑后提示 Kit 不匹配原因PVZ.pro.user里记录了原作者的 Qt 版本和编译器路径。解决删掉PVZ.pro.user让 Qt Creator 重新生成或者直接在 Kit 选择里手动指定本机可用的 Desktop Kit。5.3 现象僵尸移动速度忽快忽慢原因主定时器间隔和逻辑里的速度步长不匹配或者机器性能差异导致定时器实际触发间隔漂移。解决不要依赖固定步长改用QElapsedTimer计算真实经过时间再按时间比例移动。5.4 现象中文路径下编译报错原因qmake 和部分编译器对非 ASCII 路径支持不好。解决工程放到纯英文路径这是最省事的办法别去折腾编码转换。5.5 现象改了图片但游戏里还是旧图原因资源已经编进可执行文件改.qrc后没有重新构建。解决修改.qrc后必须重新 qmake 再 make光改图片文件不重新编译资源是不生效的。6. 进阶玩法把这份源码改成你自己的版本跑通只是第一步这份源码真正的价值在于它是个可改的骨架。我一般会先做三件事来验证自己是否真的读懂了它。第一件是加一种新植物。照着peas.cpp复制一份改类名、改攻击方式、在setplants里注册卡片、在res.qrc里加图片。如果这步能独立完成说明你已经摸清了植物类的继承关系和资源引用方式。第二件是调难度曲线。把僵尸生成间隔和移动速度做成可配置参数而不是写死在代码里。常见做法是读一个 JSON 或 ini 文件// 从配置文件读难度参数避免每次改难度都重新编译 QSettings settings(config.ini, QSettings::IniFormat); int zombieSpeed settings.value(game/zombieSpeed, 2).toInt(); int spawnInterval settings.value(game/spawnInterval, 5000).toInt();QSettings是 Qt 自带的配置读写类支持 ini 和注册表。把速度、间隔、阳光产量这些数值抽出来改平衡性就不用碰代码了。第三件是验证多线程是否真的安全。plantthread如果确实开了线程要检查它有没有直接操作 UI 对象。跨线程更新界面必须走信号槽用Qt::QueuedConnection连接。如果发现线程里直接调了update()或改了控件属性那就是隐患低负载时不崩僵尸一多就可能出问题。改造方向涉及文件关键注意点加新植物plants/peas/setplants/res.qrc继承关系、卡片注册、资源路径调难度zombie/zombies/config速度与生成间隔同步加音效gamemedia/res.qrcQMediaPlayer 生命周期存档新增类 QFile序列化格式与版本兼容我自己的习惯是每次改完一个模块先只跑那一块别一次性改五六个文件再编译不然报错都定位不到是哪改出来的。从那以后我每次动这种别人写的 Qt 工程都强制先原样编译跑通一遍再动第一行代码。希望帮到你。本文还有配套的精品资源点击获取