尧图网站建设 
简介这是一份来自传智教育Qt课程的「翻金币小游戏」完整项目源码面向正在学习Qt C、希望通过实战巩固图形界面编程的初学者与进阶开发者。项目内置二十个难度递进的关卡涵盖游戏场景搭建、金币翻转动画、信号与槽交互、关卡数据存储与切换、得分与时间状态管理等核心知识点是理解Qt框架综合应用的典型练手案例。压缩包共93个文件约27.6MB包含7个cpp与6个头文件承载核心逻辑配套ui界面文件、qrc资源脚本与pro工程配置另有大量png图片、wav音效、qm翻译文件及运行所需dll动态库并附带可直接运行的exe程序方便对照源码调试体验。目前已有592人学习下载。借助这份资源读者可完整梳理Qt项目的目录组织与模块划分掌握QGraphicsView场景渲染、动画框架与Model/View架构的落地写法并积累性能优化与内存管理的排错经验。1. 翻金币小游戏拆包一份能跑通二十关的 Qt C 实战工程翻金币小游戏这个资源是传智教育 Qt 课程里那个经典的二十关项目压缩包解开后是一套完整的 Qt C 工程带源码、资源、可执行文件和一堆运行时 DLL。它的价值不在于游戏本身多好玩而在于它把 Qt 的 QGraphicsView 场景体系、信号槽、资源系统、多媒体播放、事件分发这几块核心能力全串进了一个能跑起来的闭环里。你拿到手能直接双击 Coin.exe 看效果也能用 Qt Creator 打开 Coin.pro 改代码重新编译。适合谁刚学完 Qt 控件、想找一个有界面有交互有音效的完整项目练手的人也适合想研究 QGraphicsItem 自定义绘制和关卡数据结构设计的人。我拆这个包的时候第一反应是这玩意儿麻雀虽小但该有的坑一个不少。2. 工程结构与核心类拆解从 Coin.pro 到四个场景类2.1 先看文件清单搞清哪些是源码哪些是运行时解压后目录里文件很杂容易看花眼。我一般先按后缀分三类.cpp/.h/.pro/.ui是你要读要改的.png/.wav/.qrc是资源剩下成堆的.dll和platforms/、imageformats/、audio/、mediaservice/这些子目录是 Qt 的部署依赖删了 exe 就跑不起来。核心源码文件其实就这几个文件作用main.cpp程序入口创建 MainWindowmainwindow.h/.cpp/.ui主窗口承载 QGraphicsViewmypushbutton.h/.cpp自定义按钮带按下/悬停态切换mycoin.h/.cpp金币图元继承 QGraphicsItem负责翻转绘制chooselevelscene.h/.cpp选关场景playscene.h/.cpp游戏主场景核心逻辑都在这dataconfig.h/.cpp关卡数据配置二十关的布局存在这Coin.pro.user和Coin.pro.user.22是 Qt Creator 生成的本地用户配置换机器打开会提示重新配置套件不用管它删掉让 Creator 重新生成也行。2.2 场景切换的骨架QGraphicsView 多 Scene这个项目没有用 QStackedWidget 堆页面而是走 QGraphicsView 换 Scene 的路子。MainWindow 里放一个 QGraphicsView选关和游戏分别对应 ChooseLevelScene 和 PlayScene切换时调view-setScene(newScene)。这种做法的好处是场景内所有图元统一走 QGraphicsItem 的坐标系和事件体系金币翻转、按钮点击都能用同一套鼠标事件处理。// mainwindow.cpp 里典型的场景切换写法 void MainWindow::chooseScene() { ChooseLevelScene *chooseScene new ChooseLevelScene; // 先断开旧场景的信号避免切回来时重复连接 connect(chooseScene, ChooseLevelScene::chooseSceneBack, this, [](){ this-setFixedSize(this-width(), this-height()); // 回到选关前的处理 }); this-view-setScene(chooseScene); }这里有个容易忽略的点每次new一个 Scene 塞给 View旧 Scene 并不会自动释放。关卡来回切几次内存就慢慢涨。常见做法是在setScene之前手动delete旧 scene或者把 Scene 做成成员变量复用。我一般会在切换函数里先判断if(this-view-scene()) delete this-view-scene();虽然粗暴但有效。2.3 mycoin 的翻转paint 里根据标志位换图金币翻转不是真做了 3D 旋转而是维护一个flag布尔值在paint()里根据 flag 决定画正面图还是反面图。这是 2D 游戏里最省事的“翻转”实现。// mycoin.cpp 核心绘制逻辑 void MyCoin::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) { if(this-flag) { // flag 为 true 画金币正面 painter-drawPixmap(-this-width()/2, -this-height()/2, this-pixmap); } else { // flag 为 false 画银币反面 painter-drawPixmap(-this-width()/2, -this-height()/2, this-pixmap2); } }flag在鼠标点击事件里取反然后调update()触发重绘。参数上注意drawPixmap的坐标是相对图元中心的所以减了宽高的一半这样图元的pos()就代表金币中心点摆关卡时算坐标更直观。如果你把坐标写成(0,0)金币会以左上角对齐二十关摆下来位置全偏。3. 从零编译到跑起来Qt Creator 配置与依赖处理3.1 打开 Coin.pro 前先确认套件版本这个工程是 Qt 5 时代的产物.pro里大概率写了QT core gui widgets multimedia。用 Qt 5.15.2 或 Qt 5.12 的 MinGW 套件打开最稳。如果你装的是 Qt 6QMediaPlayer的 API 变了multimedia模块的用法不兼容编译会报一堆错。热词里常出现的cannot mix incompatible qt library就是 DLL 版本和编译版本对不上导致的所以要么统一用 Qt 5要么做好改代码的准备。打开步骤Qt Creator → 文件 → 打开文件或项目 → 选 Coin.pro → 选套件MinGW 64-bit→ 配置项目 → 构建。第一次构建如果报cannot find -lpublic之类基本是.pro里LIBS路径写死了作者机器的路径把那一行删掉或改成相对路径即可。3.2 资源系统res.qrc 怎么把图片音频编进程序工程里有个res.qrc这是 Qt 的资源集合文件。它把res/目录下的 png 和 wav 用前缀映射成:/xxx.png这样的虚拟路径编译时二进制内容直接嵌进 exe。所以你看到源码里写QPixmap(:/res/Coin0001.png)而不是磁盘路径。!-- res.qrc 结构示意 -- RCC qresource prefix/res fileCoin0001.png/file fileMenuSceneBg.png/file file16_CoinFlip_res_ConFlipSound.wav/file /qresource /RCC如果你要换图把新图放进res/目录在 Qt Creator 里右键 qrc 文件 → Open in Editor → Add Files重新构建即可。注意文件名大小写Windows 下不敏感但 Qt 资源系统是敏感的coin0001.png和Coin0001.png会被当成两个文件。3.3 音频播放QSound 还是 QMediaPlayer工程里带了Qt5Multimedia.dll和mediaservice/目录说明用了多媒体模块。翻金币的音效翻转声、按钮声、过关声常见两种实现老版本用QSound::play(:/res/xxx.wav)新版本用QMediaPlayerQMediaContent。QSound 简单但只能播 wav 且不支持音量控制QMediaPlayer 功能全但需要 mediaservice 插件支持。// 用 QMediaPlayer 播放翻转音效的典型写法 QMediaPlayer *player new QMediaPlayer(this); player-setMedia(QUrl(qrc:/res/16_CoinFlip_res_ConFlipSound.wav)); player-setVolume(80); player-play();参数上setVolume范围 0-100。如果你发现编译过了但没声音先检查mediaservice/qtaudio_windows.dll在不在 exe 同级目录再检查 wav 文件是不是标准 PCM 格式——有些工具导出的 wav 带额外元数据QMediaPlayer 会静默失败。4. 关卡数据与游戏逻辑dataconfig 怎么存二十关4.1 二维数组存金币布局dataconfig这个类的作用是把每一关的金币排列正面/反面用数据结构描述出来。最直接的做法是每关一个二维数组1 代表金币0 代表银币行列数决定关卡网格大小。// dataconfig.cpp 里关卡数据的典型组织方式 void DataConfig::initData() { // 第一关4x4 全金币 QVectorQVectorint level1; for(int i 0; i 4; i) { QVectorint row; for(int j 0; j 4; j) { row.push_back(1); // 1 表示金币 } level1.push_back(row); } this-mData.insert(1, level1); // 后续关卡按同样结构追加难度通过网格大小和初始正反比例调整 }用QVectorQVectorint而不是裸数组是因为关卡数量和数据量在编译期不确定QVector 自动管理内存insert到 QMap 里按关卡号索引也方便。参数上注意如果你把 1/0 的含义搞反了游戏逻辑里判断翻转条件就会全错表现为点一下金币全变银币或者根本翻不动。4.2 翻转判定与过关检测翻金币的核心规则通常是点击一个金币它自己和上下左右相邻的金币一起翻转。过关条件是所有金币都变成同一面通常要求全正面。判定逻辑放在 PlayScene 里每次翻转后遍历整个网格检查。// playscene.cpp 过关检测的典型实现 bool PlayScene::checkWin() { for(int i 0; i mRows; i) { for(int j 0; j mCols; j) { if(!mCoins[i][j]-getFlag()) { // 只要有一个不是正面 return false; } } } return true; }getFlag()返回金币当前状态。这里有个性能上的小坑如果每次点击都全量遍历二十关大网格下会有轻微卡顿。常见优化是维护一个计数器翻转时增减归零即过关。但作为教学项目全量遍历更直观改不改看你需求。4.3 关卡切换与状态重置从选关场景进入某一关时PlayScene 需要根据关卡号从 DataConfig 取数据、创建对应数量的 MyCoin 图元、摆到计算好的坐标上。返回选关时要把当前 PlayScene 销毁或重置否则再进同一关会叠加两套金币。// 进入关卡时创建金币图元 void PlayScene::initLevel(int levelNum) { QVectorQVectorint data mConfig-mData[levelNum]; mRows data.size(); mCols data[0].size(); for(int i 0; i mRows; i) { for(int j 0; j mCols; j) { MyCoin *coin new MyCoin(data[i][j] ? :/res/Coin0001.png : :/res/Coin0008.png); coin-setPos(/* 根据 i,j 算出的中心坐标 */); this-addItem(coin); mCoins[i][j] coin; } } }坐标计算一般是startX j * (coinWidth gap)和startY i * (coinHeight gap)startX/startY 是网格左上角第一个金币的中心点。gap 设太小金币会叠在一起设太大超出场景边界调的时候对着背景图量一下。5. 避坑与排查DLL 缺失、闪退、音效不响的常见原因5.1 双击 exe 报缺少 Qt5Core.dll现象直接运行 Coin.exe 弹窗提示找不到 Qt5Core.dll 或其他 Qt5*.dll。 原因编译时链接的是 Qt 安装目录下的动态库运行时系统 PATH 里没有 Qt 的 bin 目录。 解决用windeployqt工具自动拷贝依赖。在 Qt 命令行里执行windeployqt Coin.exe它会把 Qt5Core、Qt5Gui、Qt5Widgets、platforms/qwindows.dll 等一并放到 exe 同级目录。压缩包里已经带了这些 DLL如果你重新编译记得重新跑一遍。5.2 程序启动闪退无任何提示现象双击 exe 窗口一闪就没了或者 Qt Creator 里运行直接崩。 原因最常见的是qwindows.dll平台插件没找到Qt 报could not find the qt platform plugin windows。热词里那个could not find the qt platform plugin linuxfb是同类问题只是平台不同。 解决确认 exe 同级有platforms/qwindows.dll。如果是从压缩包直接拷 exe 出来单独跑必然缺这个目录。另外检查 DLL 位数是否匹配64 位 exe 配 64 位 DLL混了 32 位的会闪退。5.3 音效不播放但程序正常现象游戏能玩金币能翻但没有任何声音。 原因一是mediaservice/目录缺失或里面没有qtaudio_windows.dll二是 wav 文件路径写错资源系统里找不到三是系统音频设备被独占。 解决先确认mediaservice目录在 exe 同级且包含qtaudio_windows.dll和dsengine.dll。再在代码里加qDebug() player-errorString();看具体报错。如果是资源路径问题检查 qrc 里文件前缀和代码里写的是否一致。5.4 重新编译后界面图片全丢现象自己改完代码重新构建按钮和背景变成空白或默认灰色。 原因.pro里没有把res.qrc加入RESOURCES或者 qrc 文件路径变了。 解决打开 Coin.pro 确认有RESOURCES res.qrc这一行。如果 qrc 文件被移动过路径要同步改。改完执行一次 qmake构建 → 执行 qmake再重新构建。5.5 关卡切换后旧金币还在现象从第一关返回选关再进第二关发现第一关的金币还叠在场景里。 原因PlayScene 对象没被销毁或者销毁了但图元没从场景移除。 解决切换场景时确保旧 PlayScene 被 delete。如果 Scene 是new出来的在setScene新场景前delete旧的。更稳妥的做法是把金币图元的创建和销毁封装在 PlayScene 的构造和析构里析构时clear()场景。6. 进阶玩法用 QPropertyAnimation 做真翻转与自定义过关动画前面说的翻转是换图视觉上比较生硬。想让金币有“翻过去”的动画感可以用QPropertyAnimation对图元的scaleX或自定义属性做插值。思路是点击时先把金币横向缩放从 1 动画到 0到 0 的瞬间切换 flag 换图再从 0 动画回 1。这样看起来就像硬币绕竖轴转了一圈。// 用 QPropertyAnimation 做翻转动画的骨架 void MyCoin::flipWithAnimation() { QPropertyAnimation *anim new QPropertyAnimation(this, scaleX); anim-setDuration(150); anim-setStartValue(1.0); anim-setEndValue(0.0); connect(anim, QPropertyAnimation::finished, this, [](){ this-flag !this-flag; // 动画到 0 时换面 this-update(); QPropertyAnimation *back new QPropertyAnimation(this, scaleX); back-setDuration(150); back-setStartValue(0.0); back-setEndValue(1.0); back-start(QAbstractAnimation::DeleteWhenStopped); }); anim-start(QAbstractAnimation::DeleteWhenStopped); }这里scaleX是 QGraphicsItem 自带的变换属性直接拿来做动画不用额外定义。DeleteWhenStopped保证动画对象播完自动释放不然每点一次漏一个对象二十关点下来内存里全是废弃动画。参数上 duration 设 150ms 比较跟手设 300ms 以上会感觉点击有延迟设 50ms 以下看不出翻转过程。过关动画可以更进一步所有金币依次做一个小幅弹跳用QSequentialAnimationGroup串起来每个金币延迟 30ms 启动形成波浪效果。这个不是必须的但加上之后整个项目的完成度会明显不一样面试时拿出来讲也有东西说。我自己的习惯是每次改完动画相关代码都会在paint()里临时加一行qDebug() this-flag this-scale();确认状态切换和缩放值符合预期因为动画和重绘的时序问题光看界面有时候会骗人。从那以后我每次做图元动画都强制走一遍这个打印验证省得调半天发现是 update 没触发。希望帮到你。本文还有配套的精品资源点击获取 Qt C++实战：翻金币小游戏二十关工程拆解与避坑指南
简介这是一份来自传智教育Qt课程的「翻金币小游戏」完整项目源码面向正在学习Qt C、希望通过实战巩固图形界面编程的初学者与进阶开发者。项目内置二十个难度递进的关卡涵盖游戏场景搭建、金币翻转动画、信号与槽交互、关卡数据存储与切换、得分与时间状态管理等核心知识点是理解Qt框架综合应用的典型练手案例。压缩包共93个文件约27.6MB包含7个cpp与6个头文件承载核心逻辑配套ui界面文件、qrc资源脚本与pro工程配置另有大量png图片、wav音效、qm翻译文件及运行所需dll动态库并附带可直接运行的exe程序方便对照源码调试体验。目前已有592人学习下载。借助这份资源读者可完整梳理Qt项目的目录组织与模块划分掌握QGraphicsView场景渲染、动画框架与Model/View架构的落地写法并积累性能优化与内存管理的排错经验。1. 翻金币小游戏拆包一份能跑通二十关的 Qt C 实战工程翻金币小游戏这个资源是传智教育 Qt 课程里那个经典的二十关项目压缩包解开后是一套完整的 Qt C 工程带源码、资源、可执行文件和一堆运行时 DLL。它的价值不在于游戏本身多好玩而在于它把 Qt 的 QGraphicsView 场景体系、信号槽、资源系统、多媒体播放、事件分发这几块核心能力全串进了一个能跑起来的闭环里。你拿到手能直接双击 Coin.exe 看效果也能用 Qt Creator 打开 Coin.pro 改代码重新编译。适合谁刚学完 Qt 控件、想找一个有界面有交互有音效的完整项目练手的人也适合想研究 QGraphicsItem 自定义绘制和关卡数据结构设计的人。我拆这个包的时候第一反应是这玩意儿麻雀虽小但该有的坑一个不少。2. 工程结构与核心类拆解从 Coin.pro 到四个场景类2.1 先看文件清单搞清哪些是源码哪些是运行时解压后目录里文件很杂容易看花眼。我一般先按后缀分三类.cpp/.h/.pro/.ui是你要读要改的.png/.wav/.qrc是资源剩下成堆的.dll和platforms/、imageformats/、audio/、mediaservice/这些子目录是 Qt 的部署依赖删了 exe 就跑不起来。核心源码文件其实就这几个文件作用main.cpp程序入口创建 MainWindowmainwindow.h/.cpp/.ui主窗口承载 QGraphicsViewmypushbutton.h/.cpp自定义按钮带按下/悬停态切换mycoin.h/.cpp金币图元继承 QGraphicsItem负责翻转绘制chooselevelscene.h/.cpp选关场景playscene.h/.cpp游戏主场景核心逻辑都在这dataconfig.h/.cpp关卡数据配置二十关的布局存在这Coin.pro.user和Coin.pro.user.22是 Qt Creator 生成的本地用户配置换机器打开会提示重新配置套件不用管它删掉让 Creator 重新生成也行。2.2 场景切换的骨架QGraphicsView 多 Scene这个项目没有用 QStackedWidget 堆页面而是走 QGraphicsView 换 Scene 的路子。MainWindow 里放一个 QGraphicsView选关和游戏分别对应 ChooseLevelScene 和 PlayScene切换时调view-setScene(newScene)。这种做法的好处是场景内所有图元统一走 QGraphicsItem 的坐标系和事件体系金币翻转、按钮点击都能用同一套鼠标事件处理。// mainwindow.cpp 里典型的场景切换写法 void MainWindow::chooseScene() { ChooseLevelScene *chooseScene new ChooseLevelScene; // 先断开旧场景的信号避免切回来时重复连接 connect(chooseScene, ChooseLevelScene::chooseSceneBack, this, [](){ this-setFixedSize(this-width(), this-height()); // 回到选关前的处理 }); this-view-setScene(chooseScene); }这里有个容易忽略的点每次new一个 Scene 塞给 View旧 Scene 并不会自动释放。关卡来回切几次内存就慢慢涨。常见做法是在setScene之前手动delete旧 scene或者把 Scene 做成成员变量复用。我一般会在切换函数里先判断if(this-view-scene()) delete this-view-scene();虽然粗暴但有效。2.3 mycoin 的翻转paint 里根据标志位换图金币翻转不是真做了 3D 旋转而是维护一个flag布尔值在paint()里根据 flag 决定画正面图还是反面图。这是 2D 游戏里最省事的“翻转”实现。// mycoin.cpp 核心绘制逻辑 void MyCoin::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) { if(this-flag) { // flag 为 true 画金币正面 painter-drawPixmap(-this-width()/2, -this-height()/2, this-pixmap); } else { // flag 为 false 画银币反面 painter-drawPixmap(-this-width()/2, -this-height()/2, this-pixmap2); } }flag在鼠标点击事件里取反然后调update()触发重绘。参数上注意drawPixmap的坐标是相对图元中心的所以减了宽高的一半这样图元的pos()就代表金币中心点摆关卡时算坐标更直观。如果你把坐标写成(0,0)金币会以左上角对齐二十关摆下来位置全偏。3. 从零编译到跑起来Qt Creator 配置与依赖处理3.1 打开 Coin.pro 前先确认套件版本这个工程是 Qt 5 时代的产物.pro里大概率写了QT core gui widgets multimedia。用 Qt 5.15.2 或 Qt 5.12 的 MinGW 套件打开最稳。如果你装的是 Qt 6QMediaPlayer的 API 变了multimedia模块的用法不兼容编译会报一堆错。热词里常出现的cannot mix incompatible qt library就是 DLL 版本和编译版本对不上导致的所以要么统一用 Qt 5要么做好改代码的准备。打开步骤Qt Creator → 文件 → 打开文件或项目 → 选 Coin.pro → 选套件MinGW 64-bit→ 配置项目 → 构建。第一次构建如果报cannot find -lpublic之类基本是.pro里LIBS路径写死了作者机器的路径把那一行删掉或改成相对路径即可。3.2 资源系统res.qrc 怎么把图片音频编进程序工程里有个res.qrc这是 Qt 的资源集合文件。它把res/目录下的 png 和 wav 用前缀映射成:/xxx.png这样的虚拟路径编译时二进制内容直接嵌进 exe。所以你看到源码里写QPixmap(:/res/Coin0001.png)而不是磁盘路径。!-- res.qrc 结构示意 -- RCC qresource prefix/res fileCoin0001.png/file fileMenuSceneBg.png/file file16_CoinFlip_res_ConFlipSound.wav/file /qresource /RCC如果你要换图把新图放进res/目录在 Qt Creator 里右键 qrc 文件 → Open in Editor → Add Files重新构建即可。注意文件名大小写Windows 下不敏感但 Qt 资源系统是敏感的coin0001.png和Coin0001.png会被当成两个文件。3.3 音频播放QSound 还是 QMediaPlayer工程里带了Qt5Multimedia.dll和mediaservice/目录说明用了多媒体模块。翻金币的音效翻转声、按钮声、过关声常见两种实现老版本用QSound::play(:/res/xxx.wav)新版本用QMediaPlayerQMediaContent。QSound 简单但只能播 wav 且不支持音量控制QMediaPlayer 功能全但需要 mediaservice 插件支持。// 用 QMediaPlayer 播放翻转音效的典型写法 QMediaPlayer *player new QMediaPlayer(this); player-setMedia(QUrl(qrc:/res/16_CoinFlip_res_ConFlipSound.wav)); player-setVolume(80); player-play();参数上setVolume范围 0-100。如果你发现编译过了但没声音先检查mediaservice/qtaudio_windows.dll在不在 exe 同级目录再检查 wav 文件是不是标准 PCM 格式——有些工具导出的 wav 带额外元数据QMediaPlayer 会静默失败。4. 关卡数据与游戏逻辑dataconfig 怎么存二十关4.1 二维数组存金币布局dataconfig这个类的作用是把每一关的金币排列正面/反面用数据结构描述出来。最直接的做法是每关一个二维数组1 代表金币0 代表银币行列数决定关卡网格大小。// dataconfig.cpp 里关卡数据的典型组织方式 void DataConfig::initData() { // 第一关4x4 全金币 QVectorQVectorint level1; for(int i 0; i 4; i) { QVectorint row; for(int j 0; j 4; j) { row.push_back(1); // 1 表示金币 } level1.push_back(row); } this-mData.insert(1, level1); // 后续关卡按同样结构追加难度通过网格大小和初始正反比例调整 }用QVectorQVectorint而不是裸数组是因为关卡数量和数据量在编译期不确定QVector 自动管理内存insert到 QMap 里按关卡号索引也方便。参数上注意如果你把 1/0 的含义搞反了游戏逻辑里判断翻转条件就会全错表现为点一下金币全变银币或者根本翻不动。4.2 翻转判定与过关检测翻金币的核心规则通常是点击一个金币它自己和上下左右相邻的金币一起翻转。过关条件是所有金币都变成同一面通常要求全正面。判定逻辑放在 PlayScene 里每次翻转后遍历整个网格检查。// playscene.cpp 过关检测的典型实现 bool PlayScene::checkWin() { for(int i 0; i mRows; i) { for(int j 0; j mCols; j) { if(!mCoins[i][j]-getFlag()) { // 只要有一个不是正面 return false; } } } return true; }getFlag()返回金币当前状态。这里有个性能上的小坑如果每次点击都全量遍历二十关大网格下会有轻微卡顿。常见优化是维护一个计数器翻转时增减归零即过关。但作为教学项目全量遍历更直观改不改看你需求。4.3 关卡切换与状态重置从选关场景进入某一关时PlayScene 需要根据关卡号从 DataConfig 取数据、创建对应数量的 MyCoin 图元、摆到计算好的坐标上。返回选关时要把当前 PlayScene 销毁或重置否则再进同一关会叠加两套金币。// 进入关卡时创建金币图元 void PlayScene::initLevel(int levelNum) { QVectorQVectorint data mConfig-mData[levelNum]; mRows data.size(); mCols data[0].size(); for(int i 0; i mRows; i) { for(int j 0; j mCols; j) { MyCoin *coin new MyCoin(data[i][j] ? :/res/Coin0001.png : :/res/Coin0008.png); coin-setPos(/* 根据 i,j 算出的中心坐标 */); this-addItem(coin); mCoins[i][j] coin; } } }坐标计算一般是startX j * (coinWidth gap)和startY i * (coinHeight gap)startX/startY 是网格左上角第一个金币的中心点。gap 设太小金币会叠在一起设太大超出场景边界调的时候对着背景图量一下。5. 避坑与排查DLL 缺失、闪退、音效不响的常见原因5.1 双击 exe 报缺少 Qt5Core.dll现象直接运行 Coin.exe 弹窗提示找不到 Qt5Core.dll 或其他 Qt5*.dll。 原因编译时链接的是 Qt 安装目录下的动态库运行时系统 PATH 里没有 Qt 的 bin 目录。 解决用windeployqt工具自动拷贝依赖。在 Qt 命令行里执行windeployqt Coin.exe它会把 Qt5Core、Qt5Gui、Qt5Widgets、platforms/qwindows.dll 等一并放到 exe 同级目录。压缩包里已经带了这些 DLL如果你重新编译记得重新跑一遍。5.2 程序启动闪退无任何提示现象双击 exe 窗口一闪就没了或者 Qt Creator 里运行直接崩。 原因最常见的是qwindows.dll平台插件没找到Qt 报could not find the qt platform plugin windows。热词里那个could not find the qt platform plugin linuxfb是同类问题只是平台不同。 解决确认 exe 同级有platforms/qwindows.dll。如果是从压缩包直接拷 exe 出来单独跑必然缺这个目录。另外检查 DLL 位数是否匹配64 位 exe 配 64 位 DLL混了 32 位的会闪退。5.3 音效不播放但程序正常现象游戏能玩金币能翻但没有任何声音。 原因一是mediaservice/目录缺失或里面没有qtaudio_windows.dll二是 wav 文件路径写错资源系统里找不到三是系统音频设备被独占。 解决先确认mediaservice目录在 exe 同级且包含qtaudio_windows.dll和dsengine.dll。再在代码里加qDebug() player-errorString();看具体报错。如果是资源路径问题检查 qrc 里文件前缀和代码里写的是否一致。5.4 重新编译后界面图片全丢现象自己改完代码重新构建按钮和背景变成空白或默认灰色。 原因.pro里没有把res.qrc加入RESOURCES或者 qrc 文件路径变了。 解决打开 Coin.pro 确认有RESOURCES res.qrc这一行。如果 qrc 文件被移动过路径要同步改。改完执行一次 qmake构建 → 执行 qmake再重新构建。5.5 关卡切换后旧金币还在现象从第一关返回选关再进第二关发现第一关的金币还叠在场景里。 原因PlayScene 对象没被销毁或者销毁了但图元没从场景移除。 解决切换场景时确保旧 PlayScene 被 delete。如果 Scene 是new出来的在setScene新场景前delete旧的。更稳妥的做法是把金币图元的创建和销毁封装在 PlayScene 的构造和析构里析构时clear()场景。6. 进阶玩法用 QPropertyAnimation 做真翻转与自定义过关动画前面说的翻转是换图视觉上比较生硬。想让金币有“翻过去”的动画感可以用QPropertyAnimation对图元的scaleX或自定义属性做插值。思路是点击时先把金币横向缩放从 1 动画到 0到 0 的瞬间切换 flag 换图再从 0 动画回 1。这样看起来就像硬币绕竖轴转了一圈。// 用 QPropertyAnimation 做翻转动画的骨架 void MyCoin::flipWithAnimation() { QPropertyAnimation *anim new QPropertyAnimation(this, scaleX); anim-setDuration(150); anim-setStartValue(1.0); anim-setEndValue(0.0); connect(anim, QPropertyAnimation::finished, this, [](){ this-flag !this-flag; // 动画到 0 时换面 this-update(); QPropertyAnimation *back new QPropertyAnimation(this, scaleX); back-setDuration(150); back-setStartValue(0.0); back-setEndValue(1.0); back-start(QAbstractAnimation::DeleteWhenStopped); }); anim-start(QAbstractAnimation::DeleteWhenStopped); }这里scaleX是 QGraphicsItem 自带的变换属性直接拿来做动画不用额外定义。DeleteWhenStopped保证动画对象播完自动释放不然每点一次漏一个对象二十关点下来内存里全是废弃动画。参数上 duration 设 150ms 比较跟手设 300ms 以上会感觉点击有延迟设 50ms 以下看不出翻转过程。过关动画可以更进一步所有金币依次做一个小幅弹跳用QSequentialAnimationGroup串起来每个金币延迟 30ms 启动形成波浪效果。这个不是必须的但加上之后整个项目的完成度会明显不一样面试时拿出来讲也有东西说。我自己的习惯是每次改完动画相关代码都会在paint()里临时加一行qDebug() this-flag this-scale();确认状态切换和缩放值符合预期因为动画和重绘的时序问题光看界面有时候会骗人。从那以后我每次做图元动画都强制走一遍这个打印验证省得调半天发现是 update 没触发。希望帮到你。本文还有配套的精品资源点击获取