简介翻金币小游戏是传智教育Qt课程中的经典实战项目设计了二十个难度递进的关卡。压缩包共93个文件大小27.6MB30个dll为Qt运行依赖库22个qm是语言翻译文件18个png用于游戏界面与金币素材7个cpp和6个h组成核心源代码4个wav包含翻币、按钮、胜利等音效另有ui、qrc、pro及可执行exe文件目录结构完整清晰。项目基于QGraphicsView与QGraphicsScene构建互动场景通过动画框架实现金币翻转效果利用信号槽机制处理点击交互并包含关卡切换、状态管理等逻辑能够帮助读者系统掌握Qt事件处理、动画制作、资源引用和工程配置等核心技能。已有591人学习下载适合Qt/C初学者或希望用完整项目巩固图形界面开发能力的开发者学习时可对照源码运行调试理解每个模块的作用并以此为基础扩展自己的小游戏。1. 这个翻金币小游戏到底在教什么它不只是按钮加动画刚接触 Qt 的人很容易把「翻金币」理解成一个简单的按钮点击游戏点一下金币翻面翻对了就过关。但传智教育的这个 Qt 课程项目真正想让你练的是一整套 GUI 应用开发的骨架——场景切换、关卡数据驱动、动画与信号槽的配合、资源管理以及最终把程序打包发布的能力。它把 20 个关卡做成一条递进线每一关都在逼你处理「状态」和「反馈」这两个桌面应用的核心问题。如果你正在学 Qt又不想成天写计算器或记事本这个项目是性价比很高的练手目标功能量适中代码量在 2000 到 4000 行之间覆盖了 QMainWindow、QPushButton 自定义、属性动画、音效播放和事件过滤这些常用内容。更重要的是它的知识点是层层递进的——前面关卡随便写能跑后面关卡数据结构不设计好就得返工。这篇文章就是按这个项目的实际落地路径来展开的。一句话先给结论这个项目你跟着课程做一遍再按我后面说的方式改造一遍Qt Widgets 和 Qt 动画框架的基本功基本就过关了。开始动工前先搞清楚它的架构不是「写游戏」而是「用 Qt 的信号槽机制做一个状态机」。2. 拆解翻金币的关卡模型把「规则」翻译成 Qt 能懂的数据结构2.1 游戏规则的数据化从 20 个关卡文件到一个二维数组翻金币的玩法本身很简单一个棋盘上摆着若干金币正面朝上或背面朝上点击一枚金币时它自己和上下左右相邻的金币全部翻面目标是让所有金币正面朝上。听起来像是逻辑游戏但关键点在于——每一关的初始布局其实就是一份写死的二维数组。这也是这个课程项目最值得学的地方把游戏关卡和代码逻辑解耦。常见做法是给每个关卡单独建一个文本文件或者直接在代码里写一个int array[4][4]这样的静态数组。我倾向于用文件驱动因为 20 个关卡的配置、后续你要新增关卡、或者改某一关的初始布局改文件比改代码安全得多。每关用一个 4x4 数组1 表示背面朝上需要翻转0 表示正面朝上不用动// 关卡文件的格式示例每行 4 个数值域 0 或 1 // 1 表示金币背面朝上目标态是全部为 0 // 0 表示金币正面朝上 1 0 1 0 0 1 0 1 1 0 1 0 0 1 0 1这个 4x4 数组会被读进一个QVectorQVectorint在游戏初始化时根据索引找到对应关卡。这里要注意一个设计选择课程原版大多采用固定数组但我建议你写一个LevelConfig类专门管理读取和校验。这样你能在关卡文件里追加注释、扩展字段比如星级条件、步数上限而不影响主逻辑。逻辑说明二维数组的行列索引直接对应界面上的按钮坐标——第 i 行第 j 列的数据决定坐标为(i, j)的 CoinButton 初始化时是正面还是背面。参数说明数组的值域必须严格限制为 0 或 1否则初始化时会出现金币状态闪烁或翻转动画异常。读取文件时建议用QFile加QTextStream逐行按空格分割做toInt()转换遇错直接跳过该关不要崩溃。2.2 界面坐标与关卡尺寸为什么 4x4 是黄金配置翻金币项目在传智教育的课程里普遍使用 4x4 底盘这一方面是传智教育课程里的经典设定另一方面也是经过验证的难度曲线选择4x4 的 16 枚金币每关初始布局有足够复杂度但又不至于让动画和点击反馈变得难理解。3x3 太简单5x5 让关卡可解性校验变的过于复杂——你设计关卡时很可能给出无解的初始布局。界面布局上每枚金币是一个固定大小的按钮常见尺寸是 70x70 像素或 80x80 像素。间距 5 到 10 像素。这样 4x4 棋盘加上边距后主窗口可以稳定控制在 600x800 以下适配大多数屏幕。我在做的时候把金币尺寸定义成常量const int kCoinSize 70; // 金币按钮边长 const int kCoinSpacing 8; // 金币间距 const int kMargin 40; // 棋盘外边距参数说明金币尺寸决定了整个窗口的视觉重心。尺寸太小正面和背面图案容易糊太大16 枚金币排布后会超出小屏显示范围。kMargin则影响游戏区域和背景图的融合感我用 40 像素时整体看最协调。快速调整布局时优先改这三个常量而不是动坐标代码。背景图片用一张 800x480 左右的图覆盖整个主窗口就能盖住大部分分辨率差异。2.3 点击事件的命中规则翻转自己加四邻注意角落和边界点击一枚金币后要翻转它自己以及上下左右四个方向的邻居。这个逻辑不复杂但要处理边界判断——角上的金币只有两个邻居边上的只有三个。最土但最稳定的写法是直接判断坐标合法性void GameWidget::flipCoin(int row, int col) { // 翻转逻辑自己 上下左右越界直接跳过 flipSingle(row, col); if (row 0) flipSingle(row - 1, col); // 上 if (row 3) flipSingle(row 1, col); // 下 if (col 0) flipSingle(row, col - 1); // 左 if (col 3) flipSingle(row, col 1); // 右 }逻辑说明flipSingle里做的事是反转当前金币的状态并触发翻转动画。这里的边界条件判断用行索引和列索引的上下界来保护也就是 row 和 col 必须在 0 到 3 之间才会去访问相邻元素。参数说明如果你把棋盘尺寸改成 5x5记得把上界 3 改成 4或者直接换成二维数组的rows()和cols()成员函数这样以后改关卡规模不用再动这个函数。这部分有个小坑部分新手会把翻转逻辑写在按钮的clicked信号处理函数里然后在函数内部再手动改其他按钮。这样不仅代码冗余而且很容易出现重复翻转——因为一个按钮被点击后如果它的邻居反过来也要翻它就会出现双重翻转。正确的做法是让flipCoin成为唯一的翻转入口所有状态变更都走这个函数。3. 核心实现用 Qt 信号槽和动画框架把「翻转」做出来3.1 自定义 CoinButton 还是用 QPushButton 加样式表翻金币项目最核心的可视化元素是一枚能翻转的金币。常见做法是子类化QPushButton也叫 CoinButton它持有当前状态正面或背面并对外提供setState(int)和flipTo(int)接口。为什么用 QPushButton 而不是 QLabel因为按钮天然支持点击事件、按下状态、焦点管理而且 QSS 能直接控制背景图切换。CoinButton 类一般长这样class CoinButton : public QPushButton { Q_OBJECT Q_PROPERTY(int state READ state WRITE setState NOTIFY stateChanged) public: explicit CoinButton(QWidget *parent nullptr); int state() const { return state_; } void setState(int state); signals: void stateChanged(int newState); private: int state_ 0; // 0 正面1 背面 };代码说明这里我加了Q_PROPERTY宏这是 Qt 属性系统的入口也是后面做属性动画的关键。stateChanged信号让外部可以监听金币状态变化用于胜利判断和音效触发。setState实现里有两步更新state_值调用setIcon或setStyleSheet切换图片最后发出stateChanged信号。参数说明state的取值约定为 0 正面、1 背面不要用布尔值因为后续扩展关卡状态时可能还要加中间态。3.2 用 QPropertyAnimation 做 3D 翻转效果把金币翻面做成 3D 翻转是视觉效果的关键也常是新手卡住的地方。Qt Widgets 里没有直接提供 3D 旋转控件但是可以用QGraphicsView加QGraphicsProxyWidget实现或者更轻量的方案——用QPropertyAnimation配合QGraphicsEffect又或者用QVariantAnimation手动控制一个「翻转进度」值再用QPainter绘制变形后的金币。我推荐第四种方案在 CoinButton 内部维护一个flipProgress变量从 0 动画到 1绘制时用drawPixmap按进度做水平缩窄。效果是金币从中间对称收缩到一条线然后再从另一面展开。视觉上接近翻转。核心代码void CoinButton::setFlipProgress(qreal progress) { flipProgress_ progress; update(); // 触发重绘 } void CoinButton::paintEvent(QPaintEvent *event) { QPainter painter(this); QPixmap pixmap state_ 0 ? frontPixmap_ : backPixmap_; qreal scale qAbs(qCos(flipProgress_ * 3.1415926 / 2)); int targetWidth static_castint(pixmap.width() * scale); if (targetWidth 1) targetWidth 1; QRect targetRect((width() - targetWidth) / 2, (height() - pixmap.height()) / 2, targetWidth, pixmap.height()); painter.drawPixmap(targetRect, pixmap); }逻辑说明绘制时通过余弦函数把翻转进度映射到宽度缩放系数——进度 0 时余弦值 1金币满宽进度 1 时余弦值接近 0金币缩成一条竖线然后立即切换状态和图标再从窄展开。这个方案避免了引入 QGraphicsView 的复杂度性能足够画面效果也过关。参数说明3.1415926 / 2的系数决定了翻转周期如果想做成「滚动翻面」而不是「对称缩放」把余弦改成线性映射即可。3.3 动画衔接点击后快速翻动状态切换避免闪烁翻转动画的时序处理是这个项目最容易翻车的地方。如果一个金币在动画进行中被再次点击会造成画面闪烁甚至状态错乱。解决方式有两个一是加互斥标志二是用animation-state()判断是否正在播放。我习惯用后者void CoinButton::flipTo(int targetState) { if (flipProgress_ 1.0 || animation_-state() QAbstractAnimation::Running) { return; // 正在翻转忽略新指令 } state_ targetState; QPropertyAnimation *anim new QPropertyAnimation(this, flipProgress, this); anim-setDuration(200); anim-setStartValue(0.0); anim-setEndValue(1.0); anim-setEasingCurve(QEasingCurve::InOutCubic); connect(anim, QPropertyAnimation::finished, this, [this]() { updateIcon(); // 动画结束后再切图标 }); anim-start(QAbstractAnimation::DeleteWhenStopped); }逻辑说明这段代码的关键在于把「图片切换」放到动画的finished回调里而不是动画开始前。否则会出现动画还没播放完图标已经变了视觉上像闪了一下。参数说明duration设为 200 毫秒比较合适。小于 120 毫秒看出抖动大于 400 毫秒会让玩家觉得拖沓。InOutCubic缓动曲线能模拟金币翻转时的加速减速感比默认的Linear舒服很多。还有一个细节是连点保护。多个金币同时被触发翻转时动画对象各自独立互不干扰但如果同一个金币被反复点击就必须用动画状态判断做拦截。上面代码里flipProgress_ 1.0的判断就是干这个的。4. 让 20 个关卡串起来主窗口、关卡选择和音效的协同4.1 场景切换的两种姿势QStackedWidget 与窗口替换翻金币课程项目涉及至少三个界面主菜单、选关页面、游戏页面。传智教育的课程原版往往用「关闭一个窗口 新建另一个窗口」的方式切换场景。我能理解课程这么设计的教学目的但真正做项目的时候窗口之间来回 new 和 delete会让内存管理变得混乱尤其在游戏页返回主菜单时如果不小心 delete 了正在执行动画的对象会直接崩溃。更稳的做法是用QStackedWidget承载三个页面切换只需一行代码ui-stackedWidget-setCurrentIndex(0); // 主菜单 ui-stackedWidget-setCurrentIndex(1); // 选关页面 ui-stackedWidget-setCurrentIndex(2); // 游戏页面逻辑说明QStackedWidget 的所有页面在初始化时一次性创建切换时只是隐藏和显示不会销毁对象所以游戏状态可以保留在内存里。参数说明页面索引从 0 开始按添加顺序排建议用枚举定义常量而不是裸数字。我见过有人直接写setCurrentIndex(1)结果后来插入一个新页面索引全乱了排查半天。用enum Page { MainMenu, LevelSelect, Game };就能避免这种低级问题。4.2 选关界面20 个关卡按钮的动态生成与状态存储选关页面需要 20 个按钮排成 4 行 5 列或者 5 行 4 列。手写 20 个按钮不现实动态生成是标准做法for (int i 0; i 20; i) { QPushButton *btn new QPushButton(QString::number(i 1), this); btn-setFixedSize(70, 70); btn-setProperty(levelIndex, i); int row i / 5, col i % 5; levelGrid-addWidget(btn, row, col); connect(btn, QPushButton::clicked, this, [this, i]() { startLevel(i); // 进入第 i1 关 }); }逻辑说明用levelGrid网格布局自动排位置按钮的clicked信号在 lambda 中捕获关卡索引这样点击任意关卡按钮都能准确进入对应关卡。参数说明levelIndex属性可以方便后续按关卡状态做样式区分——比如已通关的关卡显示为金色未解锁的显示为灰色。这里顺带说明一下「关卡解锁」的通用设计用一个QSettings或本地配置文件记录玩家最高到第几关。常见做法是首次启动写 0通关后更新为当前关卡索引加一。课程原版往往不涉及这个但自己扩展的时候优先级最高——没有解锁机制20 个关卡一键全开游戏性会大幅下降。4.3 音效与动画的并发QSoundEffect 和跨线程注意事项金币翻转时的音效、胜利时的背景音乐切换是这个项目的加分项。Qt 里播放音效的常用选择是QSoundEffect它适合短小、需要低延迟的音效背景音乐则更推荐QMediaPlayer。要注意的是 QSoundEffect 只支持 WAV 格式而且文件本身不大时加载才快。简单播放调用QSoundEffect *flipSound new QSoundEffect(this); flipSound-setSource(QUrl::fromLocalFile(:/sounds/flip.wav)); flipSound-setVolume(0.6f); // 在金币翻转时调用 flipSound-play();逻辑说明把这个对象创建成成员变量不要每次点击都 new 一次。QSoundEffect 内部有自己的播放线程play() 是非阻塞调用不会卡界面。参数说明volume值域是 0.0 到 1.00.6 比较平衡如果同时播放多个音效QSoundEffect 内部会管理混音但要注意同一对象连续调用 play() 会打断上一次播放。如果你发现音效触发有延迟先检查 WAV 的采样率和位深——44.1kHz 16bit 的单声道文件最稳定过大的立体声文件会导致首次播放卡顿。如果你的项目里界面出现假死、音效播放后又停住的情况多半是把QSoundEffect::play()或者QMediaPlayer的播放调用放在了非主线程。记住一条铁律所有和 UI 相关的操作必须回到主线程你能在子线程碰的只有数据计算。4.4 胜负判定与关卡推进遍历比维护计数器更可靠如何判断玩家是否通关最直接的方法是每次翻转动作结束后遍历 16 枚金币检查是否有任何一枚处于背面状态。有人会想我维护一个remainingCount每次翻转时增减不是更快吗这个方案在四邻翻转规则下极其容易出错——因为一个翻转操作可能同时改变多枚金币计数器会乱。bool GameWidget::checkVictory() const { for (int i 0; i 4; i) { for (int j 0; j 4; j) { if (coins_[i][j]-state() 1) { return false; // 还有背面朝上的金币 } } } return true; }逻辑说明checkVictory每次被调用都是完全遍历 4x4 数组复杂度和 16 个金币的规模完全匹配性能没有任何压力。参数说明数组coins_是存储在GameWidget中的 CoinButton 二维数组指针坐标(i, j)和关卡配置数组的行列一一对应。胜利后的流程是显示胜利弹窗或动画记录已解锁关卡然后返回到选关页面或自动进入下一关。很多新手会漏掉「胜利后依然可以点击金币」的情况。通关判定触发后应该设置一个gameOver_标志位并立刻连点保护——否则玩家在胜利动画播放过程中还能继续翻转视觉上就变成了「通关了但还在翻牌」体验很割裂。5. 常见问题与避坑清单版本、路径、打包的 5 条踩坑记录5.1 Qt 版本混用导致启动即崩fatal: cannot mix incompatible Qt library现象按下运行按钮程序编译通过但启动瞬间崩溃控制台或调试器输出类似fatal: cannot mix incompatible Qt library (version 0x??????) with this library的报错。原因几乎都是因为程序里链接的 Qt 库和你运行时加载的 Qt 库不是同一套。典型情况是你用 Qt 6.x 编译但系统 PATH 环境变量里指向了 Qt 5.x 的 bin 目录或者你的项目配置里包含了两个不同版本的 Qt 模块搜索路径。还有一种隐蔽的情况你把一个 Qt 5 编译过的插件或第三方库文件比如 qwindows.dll、styles 插件放进了 Qt 6 的 platforms 目录。解决到「Qt 安装目录」的 Settings 里检查编译器套件和 Qt 版本是否匹配然后把环境变量PATH中 Qt 路径置顶。如果还不行清理 build 目录的.qmake.stash和Makefile后重新 qmake。最简单的手段是过程中坚持使用同一套「Qt 版本 编译套件」组合不要混合套装。5.2 linuxfb 插件缺失qt.qpa.plugin: could not find the Qt platform plugin linuxfb现象在嵌入式设备或 ARM 开发板上运行程序时报qt.qpa.plugin: could not find the Qt platform plugin linuxfb。原因你的 Qt 构建里没有安装 linuxfb 的插件或者插件路径没有被打包进程序的部署目录。这个报错在交叉编译的 Qt 程序里最常见——主机上可以跑拷到板子上就报错。解决到你的 Qt 编译产物目录里找到plugins/platforms文件夹确认libqlinuxfb.so存在。如果不存在重新 configure Qt 时开启-linuxfb选项。如果存在但程序还是找不到用export QT_QPA_PLATFORM_PLUGIN_PATH/path/to/plugins/platforms显式指定。程序发布时这整个plugins目录要一起拷过去位置相对可执行文件通常为./plugins/。注意如果你的目标平台是银河麒麟这类国产系统或者树莓派这类 ARM 设备先把QT_QPA_PLATFORM设置成offscreen测试界面是否能加载能加载再回去排查 linuxfb 的问题这样可以快速区分是插件缺失还是显示后端的问题。5.3 资源图片和音效加载不出来路径玄学现象在 Qt Creator 里运行正常双击 exe 或发布后运行的版本里图片全部变成空白。原因你用了相对路径加载资源比如QIcon(:/images/coin.png)写成了QIcon(images/coin.png)。前者是 Qt 资源系统路径后者是磁盘相对路径。两种情况对工作目录的敏感度不同——磁盘相对路径依赖程序运行时的当前工作目录而这个目录未必是 exe 所在目录。解决所有图片、音频统一收进.qrc资源文件用:/前缀访问。这样资源会直接编译进二进制不存在路径问题。如果你的资源体积很大比如背景音乐几 MB就做成外部资源目录然后在代码里用QCoreApplication::applicationDirPath()拼接绝对路径不要用相对路径。5.4 安卓发布时找不到 Qt 库在 android 上运行时抛java.lang.UnsatisfiedLinkError现象用 Qt Creator 构建 Android APK 时成功但安装到手机后打开瞬间崩溃日志提示找不到 Qt 加载库或QtCore相关 JNI 库。原因绝大多数情况是没有把 Qt 的 Android 构建套件作为目标——你的 Kit 选择了桌面 Qt 的 MinGW 或 MSVC却又勾选了 Android 平台打包时把桌面版动态库塞进了 APK或者是缺少 Android 的libQt6Core.so等库文件。解决在「Kit」里新增 Android 套件选择你安装 Qt 版本时一起装的 Android 版通常会带android_arm64_v8a标识。创建构建套件后在 Projects 页面的 Build Settings 里确认目标平台是 Android。然后使用「构建 APK」按钮而不是「运行」按钮。首次打包会自动调用androiddeployqt这一步如果日志中有androiddeployqt报错检查你的 JDK、SDK、NDK 路径是否全部配置正确。NDK 版本不匹配是 Android 构建失败的高频原因。5.5 MSVC 编译报错 LNK2019/LNK2001外部符号无法解析现象在 Windows 上用 MSVC 套件编译时链接阶段报LNK2019 unresolved external symbol ...或者LNK2001。核心代码在 MinGW 下没问题切到 MSVC 就挂。原因你在类里声明了带Q_OBJECT的类但 moc 文件没有被生成或者没有被正确参与编译还有一种常见原因是信号函数只声明没定义或者槽函数声明为 private 但在源码文件里没有实现。MSVC 的链接错误信息比 MinGW 更晦涩新手容易被符号描述带偏。解决先跑到 build 目录下确认.moc或moc_xxx.cpp文件是否出现在Generated Files文件夹。如果没有对项目执行「qmake」重新生成 MakefileMSVC 构建下需要同时删除.vcxproj.user文件避免残留配置。如果是信号槽声明了没实现在头文件里把信号和槽的定义补齐。课程代码用 MinGW 写的移植到 MSVC 环境时的常见翻车点就是这里。6. 从课程项目到自研作品关卡生成器与双端发布技巧把 20 个关卡做出来之后你会发现最花时间的不是写代码而是设计关卡数据本身——初始布局要合理不能太简单也不能无解。传智教育课程里只给了一个固定的关卡表。但既然已经上手了我建议你做三件事把这套技能变成能反复用的能力。第一件写一个「逆推关卡生成器」。判断一个初始布局是否有解比设计一个新关卡要难得多。更聪明的思路是反着来从全正面状态开始随机点击若干次金币把每次点击后的状态保存成目标初始态。这样就保证一定存在解法。生成器代码可以独立成一个命令行小工具生成的关卡数据直接输出成关卡文件格式。用自己的生成器批量生成 100 个关卡再手动从中挑出难度合适的这个过程非常有趣而且你彻底摆脱了课程提供的固定表。生成的伪代码思路QVectorQVectorint generateLevel(int seed, int flipCount) { QVectorQVectorint board(4, QVectorint(4, 0)); QRandomGenerator rng(seed); for (int i 0; i flipCount; i) { int r rng.bounded(4); int c rng.bounded(4); flipBoard(board, r, c); // 复用游戏里的翻转规则 } return board; }逻辑说明flipBoard和游戏逻辑里的flipCoin保持同一套翻转规则保证生成的布局在规则下可达。参数说明seed固定后生成的关卡序列完全一致方便复现flipCount控制难度——6 到 8 次点击量对应新手关12 次以上对应高级关。你可以先看单关再到游戏里去试调出一个自己满意的难度区间。第二件把项目切到 CMake 构建。传智教育课程项目传统上用 qmake.pro文件管理。qmake 的优点是简单但你要发布到 Android 和嵌入式平台维护多套配置时就变得很痛苦。CMake 已经成为 Qt 官方当前力推的构建方式社区资源也多。把项目从.pro迁移到 CMakeLists.txt核心是find_package(Qt6 COMPONENTS Widgets Multimedia)和qt_add_executable这种声明式语句。迁移成本可能有一个下午的时间但换来的是一套配置在 Windows、macOS、Linux、Android 上都能编译的工程结构。第三件了解 Qt 6.11 与 Visual Studio 2026 的配合方式。新版本 Qt 对 MSVC 的版本支持比较严格直接原因是 Qt 库内部使用了某些与编译器版本相关的 C 特性。如果你用的是 2026 版本的 Visual Studio 但 Qt 版本偏老编译报错最常见的表现就是头文件里的no matching constructor或fatal error C1189。遇到这类问题先不要怀疑自己的代码检查 Qt 安装文档中标注的编译器版本范围。通常的解法是装一个与 Qt 版本匹配的 MSVC 工具集或者在 Kit 里定义一个新的「编译器 Qt 版本」组合。代码写到这里真正影响产出质量的已经不是语法层面——而是你愿不愿意抽出两天时间把这两件事做完做一个能生成任意数量关卡的生成器以及把课程里极大的「主窗口到处 new」结构改造成基于栈式页面的架构。我的习惯是做完课程项目后立刻拉一个分支重构一遍把不理解的地方全部标出来然后逐个击破。这个过程里遇到的那几个坑基本就是前面写的那些版本混用、资源路径、MSVC 链接、Android 部署。希望你能把课程项目当作一个起点而不是终点。等你想明白这 20 个关卡背后的状态和数据结构设计再去写别的 Qt 应用——无论是桌面工具还是嵌入式界面——思路都会顺很多。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/9/23 13:23:20 · 阅读 1.2k Qt翻金币游戏实战：从信号槽到动画框架的GUI开发全解析
简介翻金币小游戏是传智教育Qt课程中的经典实战项目设计了二十个难度递进的关卡。压缩包共93个文件大小27.6MB30个dll为Qt运行依赖库22个qm是语言翻译文件18个png用于游戏界面与金币素材7个cpp和6个h组成核心源代码4个wav包含翻币、按钮、胜利等音效另有ui、qrc、pro及可执行exe文件目录结构完整清晰。项目基于QGraphicsView与QGraphicsScene构建互动场景通过动画框架实现金币翻转效果利用信号槽机制处理点击交互并包含关卡切换、状态管理等逻辑能够帮助读者系统掌握Qt事件处理、动画制作、资源引用和工程配置等核心技能。已有591人学习下载适合Qt/C初学者或希望用完整项目巩固图形界面开发能力的开发者学习时可对照源码运行调试理解每个模块的作用并以此为基础扩展自己的小游戏。1. 这个翻金币小游戏到底在教什么它不只是按钮加动画刚接触 Qt 的人很容易把「翻金币」理解成一个简单的按钮点击游戏点一下金币翻面翻对了就过关。但传智教育的这个 Qt 课程项目真正想让你练的是一整套 GUI 应用开发的骨架——场景切换、关卡数据驱动、动画与信号槽的配合、资源管理以及最终把程序打包发布的能力。它把 20 个关卡做成一条递进线每一关都在逼你处理「状态」和「反馈」这两个桌面应用的核心问题。如果你正在学 Qt又不想成天写计算器或记事本这个项目是性价比很高的练手目标功能量适中代码量在 2000 到 4000 行之间覆盖了 QMainWindow、QPushButton 自定义、属性动画、音效播放和事件过滤这些常用内容。更重要的是它的知识点是层层递进的——前面关卡随便写能跑后面关卡数据结构不设计好就得返工。这篇文章就是按这个项目的实际落地路径来展开的。一句话先给结论这个项目你跟着课程做一遍再按我后面说的方式改造一遍Qt Widgets 和 Qt 动画框架的基本功基本就过关了。开始动工前先搞清楚它的架构不是「写游戏」而是「用 Qt 的信号槽机制做一个状态机」。2. 拆解翻金币的关卡模型把「规则」翻译成 Qt 能懂的数据结构2.1 游戏规则的数据化从 20 个关卡文件到一个二维数组翻金币的玩法本身很简单一个棋盘上摆着若干金币正面朝上或背面朝上点击一枚金币时它自己和上下左右相邻的金币全部翻面目标是让所有金币正面朝上。听起来像是逻辑游戏但关键点在于——每一关的初始布局其实就是一份写死的二维数组。这也是这个课程项目最值得学的地方把游戏关卡和代码逻辑解耦。常见做法是给每个关卡单独建一个文本文件或者直接在代码里写一个int array[4][4]这样的静态数组。我倾向于用文件驱动因为 20 个关卡的配置、后续你要新增关卡、或者改某一关的初始布局改文件比改代码安全得多。每关用一个 4x4 数组1 表示背面朝上需要翻转0 表示正面朝上不用动// 关卡文件的格式示例每行 4 个数值域 0 或 1 // 1 表示金币背面朝上目标态是全部为 0 // 0 表示金币正面朝上 1 0 1 0 0 1 0 1 1 0 1 0 0 1 0 1这个 4x4 数组会被读进一个QVectorQVectorint在游戏初始化时根据索引找到对应关卡。这里要注意一个设计选择课程原版大多采用固定数组但我建议你写一个LevelConfig类专门管理读取和校验。这样你能在关卡文件里追加注释、扩展字段比如星级条件、步数上限而不影响主逻辑。逻辑说明二维数组的行列索引直接对应界面上的按钮坐标——第 i 行第 j 列的数据决定坐标为(i, j)的 CoinButton 初始化时是正面还是背面。参数说明数组的值域必须严格限制为 0 或 1否则初始化时会出现金币状态闪烁或翻转动画异常。读取文件时建议用QFile加QTextStream逐行按空格分割做toInt()转换遇错直接跳过该关不要崩溃。2.2 界面坐标与关卡尺寸为什么 4x4 是黄金配置翻金币项目在传智教育的课程里普遍使用 4x4 底盘这一方面是传智教育课程里的经典设定另一方面也是经过验证的难度曲线选择4x4 的 16 枚金币每关初始布局有足够复杂度但又不至于让动画和点击反馈变得难理解。3x3 太简单5x5 让关卡可解性校验变的过于复杂——你设计关卡时很可能给出无解的初始布局。界面布局上每枚金币是一个固定大小的按钮常见尺寸是 70x70 像素或 80x80 像素。间距 5 到 10 像素。这样 4x4 棋盘加上边距后主窗口可以稳定控制在 600x800 以下适配大多数屏幕。我在做的时候把金币尺寸定义成常量const int kCoinSize 70; // 金币按钮边长 const int kCoinSpacing 8; // 金币间距 const int kMargin 40; // 棋盘外边距参数说明金币尺寸决定了整个窗口的视觉重心。尺寸太小正面和背面图案容易糊太大16 枚金币排布后会超出小屏显示范围。kMargin则影响游戏区域和背景图的融合感我用 40 像素时整体看最协调。快速调整布局时优先改这三个常量而不是动坐标代码。背景图片用一张 800x480 左右的图覆盖整个主窗口就能盖住大部分分辨率差异。2.3 点击事件的命中规则翻转自己加四邻注意角落和边界点击一枚金币后要翻转它自己以及上下左右四个方向的邻居。这个逻辑不复杂但要处理边界判断——角上的金币只有两个邻居边上的只有三个。最土但最稳定的写法是直接判断坐标合法性void GameWidget::flipCoin(int row, int col) { // 翻转逻辑自己 上下左右越界直接跳过 flipSingle(row, col); if (row 0) flipSingle(row - 1, col); // 上 if (row 3) flipSingle(row 1, col); // 下 if (col 0) flipSingle(row, col - 1); // 左 if (col 3) flipSingle(row, col 1); // 右 }逻辑说明flipSingle里做的事是反转当前金币的状态并触发翻转动画。这里的边界条件判断用行索引和列索引的上下界来保护也就是 row 和 col 必须在 0 到 3 之间才会去访问相邻元素。参数说明如果你把棋盘尺寸改成 5x5记得把上界 3 改成 4或者直接换成二维数组的rows()和cols()成员函数这样以后改关卡规模不用再动这个函数。这部分有个小坑部分新手会把翻转逻辑写在按钮的clicked信号处理函数里然后在函数内部再手动改其他按钮。这样不仅代码冗余而且很容易出现重复翻转——因为一个按钮被点击后如果它的邻居反过来也要翻它就会出现双重翻转。正确的做法是让flipCoin成为唯一的翻转入口所有状态变更都走这个函数。3. 核心实现用 Qt 信号槽和动画框架把「翻转」做出来3.1 自定义 CoinButton 还是用 QPushButton 加样式表翻金币项目最核心的可视化元素是一枚能翻转的金币。常见做法是子类化QPushButton也叫 CoinButton它持有当前状态正面或背面并对外提供setState(int)和flipTo(int)接口。为什么用 QPushButton 而不是 QLabel因为按钮天然支持点击事件、按下状态、焦点管理而且 QSS 能直接控制背景图切换。CoinButton 类一般长这样class CoinButton : public QPushButton { Q_OBJECT Q_PROPERTY(int state READ state WRITE setState NOTIFY stateChanged) public: explicit CoinButton(QWidget *parent nullptr); int state() const { return state_; } void setState(int state); signals: void stateChanged(int newState); private: int state_ 0; // 0 正面1 背面 };代码说明这里我加了Q_PROPERTY宏这是 Qt 属性系统的入口也是后面做属性动画的关键。stateChanged信号让外部可以监听金币状态变化用于胜利判断和音效触发。setState实现里有两步更新state_值调用setIcon或setStyleSheet切换图片最后发出stateChanged信号。参数说明state的取值约定为 0 正面、1 背面不要用布尔值因为后续扩展关卡状态时可能还要加中间态。3.2 用 QPropertyAnimation 做 3D 翻转效果把金币翻面做成 3D 翻转是视觉效果的关键也常是新手卡住的地方。Qt Widgets 里没有直接提供 3D 旋转控件但是可以用QGraphicsView加QGraphicsProxyWidget实现或者更轻量的方案——用QPropertyAnimation配合QGraphicsEffect又或者用QVariantAnimation手动控制一个「翻转进度」值再用QPainter绘制变形后的金币。我推荐第四种方案在 CoinButton 内部维护一个flipProgress变量从 0 动画到 1绘制时用drawPixmap按进度做水平缩窄。效果是金币从中间对称收缩到一条线然后再从另一面展开。视觉上接近翻转。核心代码void CoinButton::setFlipProgress(qreal progress) { flipProgress_ progress; update(); // 触发重绘 } void CoinButton::paintEvent(QPaintEvent *event) { QPainter painter(this); QPixmap pixmap state_ 0 ? frontPixmap_ : backPixmap_; qreal scale qAbs(qCos(flipProgress_ * 3.1415926 / 2)); int targetWidth static_castint(pixmap.width() * scale); if (targetWidth 1) targetWidth 1; QRect targetRect((width() - targetWidth) / 2, (height() - pixmap.height()) / 2, targetWidth, pixmap.height()); painter.drawPixmap(targetRect, pixmap); }逻辑说明绘制时通过余弦函数把翻转进度映射到宽度缩放系数——进度 0 时余弦值 1金币满宽进度 1 时余弦值接近 0金币缩成一条竖线然后立即切换状态和图标再从窄展开。这个方案避免了引入 QGraphicsView 的复杂度性能足够画面效果也过关。参数说明3.1415926 / 2的系数决定了翻转周期如果想做成「滚动翻面」而不是「对称缩放」把余弦改成线性映射即可。3.3 动画衔接点击后快速翻动状态切换避免闪烁翻转动画的时序处理是这个项目最容易翻车的地方。如果一个金币在动画进行中被再次点击会造成画面闪烁甚至状态错乱。解决方式有两个一是加互斥标志二是用animation-state()判断是否正在播放。我习惯用后者void CoinButton::flipTo(int targetState) { if (flipProgress_ 1.0 || animation_-state() QAbstractAnimation::Running) { return; // 正在翻转忽略新指令 } state_ targetState; QPropertyAnimation *anim new QPropertyAnimation(this, flipProgress, this); anim-setDuration(200); anim-setStartValue(0.0); anim-setEndValue(1.0); anim-setEasingCurve(QEasingCurve::InOutCubic); connect(anim, QPropertyAnimation::finished, this, [this]() { updateIcon(); // 动画结束后再切图标 }); anim-start(QAbstractAnimation::DeleteWhenStopped); }逻辑说明这段代码的关键在于把「图片切换」放到动画的finished回调里而不是动画开始前。否则会出现动画还没播放完图标已经变了视觉上像闪了一下。参数说明duration设为 200 毫秒比较合适。小于 120 毫秒看出抖动大于 400 毫秒会让玩家觉得拖沓。InOutCubic缓动曲线能模拟金币翻转时的加速减速感比默认的Linear舒服很多。还有一个细节是连点保护。多个金币同时被触发翻转时动画对象各自独立互不干扰但如果同一个金币被反复点击就必须用动画状态判断做拦截。上面代码里flipProgress_ 1.0的判断就是干这个的。4. 让 20 个关卡串起来主窗口、关卡选择和音效的协同4.1 场景切换的两种姿势QStackedWidget 与窗口替换翻金币课程项目涉及至少三个界面主菜单、选关页面、游戏页面。传智教育的课程原版往往用「关闭一个窗口 新建另一个窗口」的方式切换场景。我能理解课程这么设计的教学目的但真正做项目的时候窗口之间来回 new 和 delete会让内存管理变得混乱尤其在游戏页返回主菜单时如果不小心 delete 了正在执行动画的对象会直接崩溃。更稳的做法是用QStackedWidget承载三个页面切换只需一行代码ui-stackedWidget-setCurrentIndex(0); // 主菜单 ui-stackedWidget-setCurrentIndex(1); // 选关页面 ui-stackedWidget-setCurrentIndex(2); // 游戏页面逻辑说明QStackedWidget 的所有页面在初始化时一次性创建切换时只是隐藏和显示不会销毁对象所以游戏状态可以保留在内存里。参数说明页面索引从 0 开始按添加顺序排建议用枚举定义常量而不是裸数字。我见过有人直接写setCurrentIndex(1)结果后来插入一个新页面索引全乱了排查半天。用enum Page { MainMenu, LevelSelect, Game };就能避免这种低级问题。4.2 选关界面20 个关卡按钮的动态生成与状态存储选关页面需要 20 个按钮排成 4 行 5 列或者 5 行 4 列。手写 20 个按钮不现实动态生成是标准做法for (int i 0; i 20; i) { QPushButton *btn new QPushButton(QString::number(i 1), this); btn-setFixedSize(70, 70); btn-setProperty(levelIndex, i); int row i / 5, col i % 5; levelGrid-addWidget(btn, row, col); connect(btn, QPushButton::clicked, this, [this, i]() { startLevel(i); // 进入第 i1 关 }); }逻辑说明用levelGrid网格布局自动排位置按钮的clicked信号在 lambda 中捕获关卡索引这样点击任意关卡按钮都能准确进入对应关卡。参数说明levelIndex属性可以方便后续按关卡状态做样式区分——比如已通关的关卡显示为金色未解锁的显示为灰色。这里顺带说明一下「关卡解锁」的通用设计用一个QSettings或本地配置文件记录玩家最高到第几关。常见做法是首次启动写 0通关后更新为当前关卡索引加一。课程原版往往不涉及这个但自己扩展的时候优先级最高——没有解锁机制20 个关卡一键全开游戏性会大幅下降。4.3 音效与动画的并发QSoundEffect 和跨线程注意事项金币翻转时的音效、胜利时的背景音乐切换是这个项目的加分项。Qt 里播放音效的常用选择是QSoundEffect它适合短小、需要低延迟的音效背景音乐则更推荐QMediaPlayer。要注意的是 QSoundEffect 只支持 WAV 格式而且文件本身不大时加载才快。简单播放调用QSoundEffect *flipSound new QSoundEffect(this); flipSound-setSource(QUrl::fromLocalFile(:/sounds/flip.wav)); flipSound-setVolume(0.6f); // 在金币翻转时调用 flipSound-play();逻辑说明把这个对象创建成成员变量不要每次点击都 new 一次。QSoundEffect 内部有自己的播放线程play() 是非阻塞调用不会卡界面。参数说明volume值域是 0.0 到 1.00.6 比较平衡如果同时播放多个音效QSoundEffect 内部会管理混音但要注意同一对象连续调用 play() 会打断上一次播放。如果你发现音效触发有延迟先检查 WAV 的采样率和位深——44.1kHz 16bit 的单声道文件最稳定过大的立体声文件会导致首次播放卡顿。如果你的项目里界面出现假死、音效播放后又停住的情况多半是把QSoundEffect::play()或者QMediaPlayer的播放调用放在了非主线程。记住一条铁律所有和 UI 相关的操作必须回到主线程你能在子线程碰的只有数据计算。4.4 胜负判定与关卡推进遍历比维护计数器更可靠如何判断玩家是否通关最直接的方法是每次翻转动作结束后遍历 16 枚金币检查是否有任何一枚处于背面状态。有人会想我维护一个remainingCount每次翻转时增减不是更快吗这个方案在四邻翻转规则下极其容易出错——因为一个翻转操作可能同时改变多枚金币计数器会乱。bool GameWidget::checkVictory() const { for (int i 0; i 4; i) { for (int j 0; j 4; j) { if (coins_[i][j]-state() 1) { return false; // 还有背面朝上的金币 } } } return true; }逻辑说明checkVictory每次被调用都是完全遍历 4x4 数组复杂度和 16 个金币的规模完全匹配性能没有任何压力。参数说明数组coins_是存储在GameWidget中的 CoinButton 二维数组指针坐标(i, j)和关卡配置数组的行列一一对应。胜利后的流程是显示胜利弹窗或动画记录已解锁关卡然后返回到选关页面或自动进入下一关。很多新手会漏掉「胜利后依然可以点击金币」的情况。通关判定触发后应该设置一个gameOver_标志位并立刻连点保护——否则玩家在胜利动画播放过程中还能继续翻转视觉上就变成了「通关了但还在翻牌」体验很割裂。5. 常见问题与避坑清单版本、路径、打包的 5 条踩坑记录5.1 Qt 版本混用导致启动即崩fatal: cannot mix incompatible Qt library现象按下运行按钮程序编译通过但启动瞬间崩溃控制台或调试器输出类似fatal: cannot mix incompatible Qt library (version 0x??????) with this library的报错。原因几乎都是因为程序里链接的 Qt 库和你运行时加载的 Qt 库不是同一套。典型情况是你用 Qt 6.x 编译但系统 PATH 环境变量里指向了 Qt 5.x 的 bin 目录或者你的项目配置里包含了两个不同版本的 Qt 模块搜索路径。还有一种隐蔽的情况你把一个 Qt 5 编译过的插件或第三方库文件比如 qwindows.dll、styles 插件放进了 Qt 6 的 platforms 目录。解决到「Qt 安装目录」的 Settings 里检查编译器套件和 Qt 版本是否匹配然后把环境变量PATH中 Qt 路径置顶。如果还不行清理 build 目录的.qmake.stash和Makefile后重新 qmake。最简单的手段是过程中坚持使用同一套「Qt 版本 编译套件」组合不要混合套装。5.2 linuxfb 插件缺失qt.qpa.plugin: could not find the Qt platform plugin linuxfb现象在嵌入式设备或 ARM 开发板上运行程序时报qt.qpa.plugin: could not find the Qt platform plugin linuxfb。原因你的 Qt 构建里没有安装 linuxfb 的插件或者插件路径没有被打包进程序的部署目录。这个报错在交叉编译的 Qt 程序里最常见——主机上可以跑拷到板子上就报错。解决到你的 Qt 编译产物目录里找到plugins/platforms文件夹确认libqlinuxfb.so存在。如果不存在重新 configure Qt 时开启-linuxfb选项。如果存在但程序还是找不到用export QT_QPA_PLATFORM_PLUGIN_PATH/path/to/plugins/platforms显式指定。程序发布时这整个plugins目录要一起拷过去位置相对可执行文件通常为./plugins/。注意如果你的目标平台是银河麒麟这类国产系统或者树莓派这类 ARM 设备先把QT_QPA_PLATFORM设置成offscreen测试界面是否能加载能加载再回去排查 linuxfb 的问题这样可以快速区分是插件缺失还是显示后端的问题。5.3 资源图片和音效加载不出来路径玄学现象在 Qt Creator 里运行正常双击 exe 或发布后运行的版本里图片全部变成空白。原因你用了相对路径加载资源比如QIcon(:/images/coin.png)写成了QIcon(images/coin.png)。前者是 Qt 资源系统路径后者是磁盘相对路径。两种情况对工作目录的敏感度不同——磁盘相对路径依赖程序运行时的当前工作目录而这个目录未必是 exe 所在目录。解决所有图片、音频统一收进.qrc资源文件用:/前缀访问。这样资源会直接编译进二进制不存在路径问题。如果你的资源体积很大比如背景音乐几 MB就做成外部资源目录然后在代码里用QCoreApplication::applicationDirPath()拼接绝对路径不要用相对路径。5.4 安卓发布时找不到 Qt 库在 android 上运行时抛java.lang.UnsatisfiedLinkError现象用 Qt Creator 构建 Android APK 时成功但安装到手机后打开瞬间崩溃日志提示找不到 Qt 加载库或QtCore相关 JNI 库。原因绝大多数情况是没有把 Qt 的 Android 构建套件作为目标——你的 Kit 选择了桌面 Qt 的 MinGW 或 MSVC却又勾选了 Android 平台打包时把桌面版动态库塞进了 APK或者是缺少 Android 的libQt6Core.so等库文件。解决在「Kit」里新增 Android 套件选择你安装 Qt 版本时一起装的 Android 版通常会带android_arm64_v8a标识。创建构建套件后在 Projects 页面的 Build Settings 里确认目标平台是 Android。然后使用「构建 APK」按钮而不是「运行」按钮。首次打包会自动调用androiddeployqt这一步如果日志中有androiddeployqt报错检查你的 JDK、SDK、NDK 路径是否全部配置正确。NDK 版本不匹配是 Android 构建失败的高频原因。5.5 MSVC 编译报错 LNK2019/LNK2001外部符号无法解析现象在 Windows 上用 MSVC 套件编译时链接阶段报LNK2019 unresolved external symbol ...或者LNK2001。核心代码在 MinGW 下没问题切到 MSVC 就挂。原因你在类里声明了带Q_OBJECT的类但 moc 文件没有被生成或者没有被正确参与编译还有一种常见原因是信号函数只声明没定义或者槽函数声明为 private 但在源码文件里没有实现。MSVC 的链接错误信息比 MinGW 更晦涩新手容易被符号描述带偏。解决先跑到 build 目录下确认.moc或moc_xxx.cpp文件是否出现在Generated Files文件夹。如果没有对项目执行「qmake」重新生成 MakefileMSVC 构建下需要同时删除.vcxproj.user文件避免残留配置。如果是信号槽声明了没实现在头文件里把信号和槽的定义补齐。课程代码用 MinGW 写的移植到 MSVC 环境时的常见翻车点就是这里。6. 从课程项目到自研作品关卡生成器与双端发布技巧把 20 个关卡做出来之后你会发现最花时间的不是写代码而是设计关卡数据本身——初始布局要合理不能太简单也不能无解。传智教育课程里只给了一个固定的关卡表。但既然已经上手了我建议你做三件事把这套技能变成能反复用的能力。第一件写一个「逆推关卡生成器」。判断一个初始布局是否有解比设计一个新关卡要难得多。更聪明的思路是反着来从全正面状态开始随机点击若干次金币把每次点击后的状态保存成目标初始态。这样就保证一定存在解法。生成器代码可以独立成一个命令行小工具生成的关卡数据直接输出成关卡文件格式。用自己的生成器批量生成 100 个关卡再手动从中挑出难度合适的这个过程非常有趣而且你彻底摆脱了课程提供的固定表。生成的伪代码思路QVectorQVectorint generateLevel(int seed, int flipCount) { QVectorQVectorint board(4, QVectorint(4, 0)); QRandomGenerator rng(seed); for (int i 0; i flipCount; i) { int r rng.bounded(4); int c rng.bounded(4); flipBoard(board, r, c); // 复用游戏里的翻转规则 } return board; }逻辑说明flipBoard和游戏逻辑里的flipCoin保持同一套翻转规则保证生成的布局在规则下可达。参数说明seed固定后生成的关卡序列完全一致方便复现flipCount控制难度——6 到 8 次点击量对应新手关12 次以上对应高级关。你可以先看单关再到游戏里去试调出一个自己满意的难度区间。第二件把项目切到 CMake 构建。传智教育课程项目传统上用 qmake.pro文件管理。qmake 的优点是简单但你要发布到 Android 和嵌入式平台维护多套配置时就变得很痛苦。CMake 已经成为 Qt 官方当前力推的构建方式社区资源也多。把项目从.pro迁移到 CMakeLists.txt核心是find_package(Qt6 COMPONENTS Widgets Multimedia)和qt_add_executable这种声明式语句。迁移成本可能有一个下午的时间但换来的是一套配置在 Windows、macOS、Linux、Android 上都能编译的工程结构。第三件了解 Qt 6.11 与 Visual Studio 2026 的配合方式。新版本 Qt 对 MSVC 的版本支持比较严格直接原因是 Qt 库内部使用了某些与编译器版本相关的 C 特性。如果你用的是 2026 版本的 Visual Studio 但 Qt 版本偏老编译报错最常见的表现就是头文件里的no matching constructor或fatal error C1189。遇到这类问题先不要怀疑自己的代码检查 Qt 安装文档中标注的编译器版本范围。通常的解法是装一个与 Qt 版本匹配的 MSVC 工具集或者在 Kit 里定义一个新的「编译器 Qt 版本」组合。代码写到这里真正影响产出质量的已经不是语法层面——而是你愿不愿意抽出两天时间把这两件事做完做一个能生成任意数量关卡的生成器以及把课程里极大的「主窗口到处 new」结构改造成基于栈式页面的架构。我的习惯是做完课程项目后立刻拉一个分支重构一遍把不理解的地方全部标出来然后逐个击破。这个过程里遇到的那几个坑基本就是前面写的那些版本混用、资源路径、MSVC 链接、Android 部署。希望你能把课程项目当作一个起点而不是终点。等你想明白这 20 个关卡背后的状态和数据结构设计再去写别的 Qt 应用——无论是桌面工具还是嵌入式界面——思路都会顺很多。希望帮到你。本文还有配套的精品资源点击获取