简介这是一份面向C与Qt4初学者的2048小游戏实战源码适合刚接触GUI编程、希望通过完整项目理解面向对象设计的学习者。项目以Qt4的QGraphicsView与QGraphicsItem构建游戏界面用GameBoard维护棋盘状态与合并规则Tile表示数字方块并处理数值更新与相邻合并GameManager负责新游戏初始化、结束判定与得分记录同时借助信号与槽机制完成用户滑动输入与游戏逻辑的联动。压缩包共6个文件约7KB包含2个cpp源文件、1个h头文件、1个ui界面文件、1个pro工程文件及1个user配置记录覆盖从界面布局到核心逻辑的完整结构。目前已有265人学习下载。通过阅读与调试这套代码读者可以掌握Qt4窗口创建、控件添加、自定义图形绘制与事件处理流程并加深对封装、继承、多态及模块化代码组织的理解是进入游戏开发领域的一块实用跳板。1. 从一份 2048qt小游戏C初学.zip 说起它到底能帮你跨过哪道坎很多人第一次搜「2048qt小游戏C初学.zip」心里想的其实不是 2048而是「我 C 语法看得差不多了但一个能跑起来的图形界面程序都没写过」。命令行里打印九九乘法表不算数冒泡排序算法c 背得再熟也不算数真正卡住新手的是从「控制台黑框」到「有窗口、有按钮、有画面刷新」这一步。2048 这个题材恰好是那道坎上最合适的台阶逻辑不复杂一个 4x4 网格、一个随机数生成、一个合并规则但要把这些接到 Qt 的信号槽、绘图事件和键盘响应上就逼着你把 C 类、容器、随机数、事件循环全用一遍。这份压缩包对应的就是这样一个最小可运行工程适合刚学完 C 基础、想找一个完整小项目练手的人也适合想用 Qt 做课程设计但不知道从哪下手的同学。它不解决高深问题但能让你第一次拥有一个「双击就能玩」的自己写的程序。2. 把 2048 拆成 Qt 能接住的四块棋盘、随机、合并、重绘2.1 为什么用 QWidget 手绘而不是拖一堆 QLabel新手拿到 Qt Creator第一反应往往是在 Qt Designer 界面设计里拖 16 个 QLabel 摆成 4x4然后去改每个格子的文字。这个做法能跑但很快就会翻车格子背景色、圆角、数字字号要一个个设合并动画没法做窗口缩放全乱。2048 这类棋盘游戏常见做法是继承 QWidget重写 paintEvent用 QPainter 自己画。这样棋盘是一个整体格子位置由行列算出来颜色和字号按数值查表改一处全盘生效。核心数据结构就一个二维数组用int board[4][4]或std::arraystd::arrayint,4,4都行。0 表示空格其余存 2、4、8 这样的数值。这个数组是唯一的状态源界面永远从它推导出来不要反过来从控件读状态——这是新手最容易埋的坑。// board.h #pragma once #include array class Board { public: Board(); void reset(); // 清空并放两个初始数字 bool move(int dir); // dir: 0上 1右 2下 3左返回是否发生移动 bool addRandomTile(); // 在空格里随机放一个 2 或 4 bool isGameOver() const; int at(int r, int c) const { return grid[r][c]; } private: std::arraystd::arrayint,4,4 grid; bool slideLine(std::arrayint,4 line); // 对一行/一列做压缩合并 };这段头文件把「状态」和「操作」分开了。move返回 bool 很关键只有真的动了才需要生成新数字和重绘否则按无效方向键也会冒新块玩家会觉得游戏在乱跳。slideLine是合并逻辑的复用单元四个方向都靠它避免写四遍几乎一样的代码。2.2 合并逻辑一次遍历搞定压缩和相加合并是 2048 唯一有点绕的地方。以向左为例一行[2,0,2,4]要先压成[2,2,4,0]再合并成[4,4,0,0]注意合并后的 4 不能和后面的 4 再合并所以每个格子一局只能参与一次合并。常见写法是先把非零元素挪到前面再从左到右扫一遍相邻相等就相加并把后一个清零。bool Board::slideLine(std::arrayint,4 line) { std::arrayint,4 old line; // 第一步压缩把非零值挤到左边 int pos 0; for (int i 0; i 4; i) if (line[i] ! 0) line[pos] line[i]; for (int i pos; i 4; i) line[i] 0; // 第二步相邻相等合并合并后跳过下一个 for (int i 0; i 3; i) { if (line[i] ! 0 line[i] line[i1]) { line[i] * 2; line[i1] 0; i; // 关键防止连锁合并 } } // 第三步再次压缩把合并产生的空位补上 pos 0; for (int i 0; i 4; i) if (line[i] ! 0) line[pos] line[i]; for (int i pos; i 4; i) line[i] 0; return line ! old; // 有变化才返回 true }参数说明line是引用传入函数直接改它。i那行是血泪经验漏了它[2,2,4,0]会变成[4,0,4,0]再被误判成能合并实际游戏里表现为「一次按键数字翻倍两次」。return line ! old用数组比较判断是否变化比手动记标志位干净。四个方向的move只是把行或列取出来、必要时反转、调用slideLine、再写回去方向处理不要和合并逻辑混在一起。2.3 随机数别再用 rand() % 2 了C 随机数这块新手最常写srand(time(0)); int v rand() % 2 ? 2 : 4;。能跑但rand()的质量和分布一直被人诟病而且每次都要手动播种。C11 之后标准做法是random#include random static std::mt19937 rng(std::random_device{}()); static std::uniform_int_distributionint tileVal(0, 9); // 90% 出 2 bool Board::addRandomTile() { std::vectorstd::pairint,int empty; for (int r 0; r 4; r) for (int c 0; c 4; c) if (grid[r][c] 0) empty.push_back({r, c}); if (empty.empty()) return false; std::uniform_int_distributionint pick(0, empty.size() - 1); auto [r, c] empty[pick(rng)]; grid[r][c] (tileVal(rng) 0) ? 4 : 2; // 约 10% 概率出 4 return true; }std::mt19937是梅森旋转引擎std::random_device负责播种比time(0)稳。tileVal(0,9)配合 0判断让 4 的出现概率约 10%这是 2048 原版的常见设定全出 2 会让游戏太慢全随机又太难。empty用 vector 收集空格再随机挑一个比「随机坐标撞到非空就重试」的写法在棋盘快满时更可靠不会卡循环。2.4 重绘与键盘paintEvent 和 keyPressEvent 的分工界面部分继承 QWidget重写两个函数。paintEvent负责画keyPressEvent负责收方向键。窗口大小变化时不要重算布局而是按当前窗口宽高动态算格子边长这样拉伸窗口棋盘会跟着缩放。void GameWidget::paintEvent(QPaintEvent*) { QPainter p(this); int margin 10; int side qMin(width(), height()) - margin * 2; int cell (side - margin * 3) / 4; // 4 格 3 条缝 for (int r 0; r 4; r) { for (int c 0; c 4; c) { QRect rect(margin c * (cell margin), margin r * (cell margin), cell, cell); int v board.at(r, c); p.setBrush(colorFor(v)); // 按数值查颜色表 p.drawRoundedRect(rect, 6, 6); if (v) { p.setPen(Qt::black); p.setFont(QFont(Arial, cell / 3, QFont::Bold)); p.drawText(rect, Qt::AlignCenter, QString::number(v)); } } } } void GameWidget::keyPressEvent(QKeyEvent* e) { int dir -1; switch (e-key()) { case Qt::Key_Up: dir 0; break; case Qt::Key_Right: dir 1; break; case Qt::Key_Down: dir 2; break; case Qt::Key_Left: dir 3; break; default: QWidget::keyPressEvent(e); return; } if (board.move(dir)) { board.addRandomTile(); update(); // 触发重绘 if (board.isGameOver()) { /* 弹提示或禁用输入 */ } } }update()只是标记需要重绘真正的paintEvent由 Qt 事件循环调度不要在里面直接调paintEvent。colorFor用一个 switch 或 QMap 把 2、4、8… 映射到颜色数值超过 2048 可以统一给个深色。字体大小用cell / 3跟着格子走窗口拉大数字也变大比写死字号自然。3. 从零把工程跑起来Qt Creator 建项、编译、发布的三段路3.1 装 Qt 与选编译器MinGW 还是 MSVCqt下载 和 qt安装 是搜索里出现频率最高的词说明很多人卡在第一步。Qt 官网下载在线安装器装的时候会让你选组件。新手建议直接勾 Qt 5.15.2 或 Qt 6.x 的 MinGW 版本因为 MinGW 自带 GCC装完就能编译不用再折腾 Visual Studio。如果你已经装了 Visual Studio也可以选 MSVC 套件但要注意 qt按照完mingw编译器后怎么安装msvc编译工具链 这类问题——Qt Creator 里换编译器要在「Kits」里配不是装完就自动认。套件优点适合谁MinGW装完即用体积小纯新手、课程作业MSVC和 Windows 生态贴合调试器强已装 VS、要做 Windows 发布QML界面声明式动画方便想做现代 UI 的人2048 这种纯 QWidget 项目MinGW 足够。装完打开 Qt Creator新建项目选「Qt Widgets Application」类名填 GameWidget基类选 QWidget它会自动生成.pro、main.cpp、gamewidget.h/cpp。把前面写的 Board 类加进去在.pro里不需要额外加模块QtWidgets 默认就有。3.2 用 qmake 还是 CMake以及 .pro 里要写什么Qt 6 默认推 CMakeQt 5 时代 qmake 更常见。新手项目两者都行但如果你搜到的教程是.pro文件就选 qmake别混着来。一个最小.proQT core gui widgets TARGET game2048 TEMPLATE app SOURCES main.cpp gamewidget.cpp board.cpp HEADERS gamewidget.h board.hQT widgets是必须的漏了会报一堆找不到 QWidget 的错。TEMPLATE app表示生成可执行程序。如果你后面想加音效再补QT multimedia。改完.pro记得在 Qt Creator 里右键项目「执行 qmake」否则新文件不参与编译。3.3 编译报错怎么读从 cannot find -l 到平台插件编译期最常见的两类错。一类是链接错误比如cannot find -lpublic这种通常是.pro里LIBS 写了个不存在的库名或者库路径没配。2048 项目不该出现出现了就检查是不是复制了别人的.pro。另一类是运行期报qt.qpa.plugin: could not find the Qt platform plugin这几乎都是发布时没带platforms文件夹或者环境变量QT_QPA_PLATFORM_PLUGIN_PATH指错了。开发阶段在 Qt Creator 里跑不会遇到一旦你双击 exe 就冒出来。# 发布时用 windeployqt 自动拷依赖在 Qt 命令行工具里执行 windeployqt game2048.exe --releasewindeployqt会把 Qt 的 dll、platforms 插件、样式插件拷到 exe 旁边。执行完目录里会多出platforms/qwindows.dll少了它程序启动就报平台插件找不到。这一步是 qt发布软件 的标准动作别手动一个个拷 dll容易漏。4. 避坑与排查新手在这份工程上最容易翻车的五件事4.1 现象按方向键没反应窗口像死了一样原因焦点不在 GameWidget 上。Qt 里键盘事件只发给有焦点的控件如果窗口里还有别的可聚焦控件或者你没设焦点策略按键就到不了keyPressEvent。 解决在 GameWidget 构造函数里加setFocusPolicy(Qt::StrongFocus);并在show()之后调setFocus()。如果嵌在别的窗口里确认没有父控件抢焦点。4.2 现象数字合并后位置错乱或者一次按键连合两次原因slideLine里合并后没有跳过下一个或者四个方向的取行/写回顺序搞反了。向左和向右共用一行时向右需要先反转再处理再反转回来漏了反转就会方向错。 解决把方向处理写成「取出一行 → 必要时反转 → slideLine → 必要时再反转 → 写回」四个方向各写一小段别想着用一个循环套所有方向可读性差还容易错。合并循环里的i一定要有。4.3 现象程序跑一会儿闪退报 0xc0000005 访问冲突原因数组越界。2048 里最常见的是move里行列索引算错或者addRandomTile在棋盘满时还去访问empty[0]。热词里 c#调用c出现access violation c0000005 也是同一类问题跨语言调用时指针没管好。 解决所有对grid[r][c]的访问前确认 r、c 在 0~3。addRandomTile先判empty.empty()再取。开 Qt Creator 的调试模式跑崩的时候看调用栈比猜快得多。4.4 现象窗口拉伸后棋盘变形格子大小不一原因paintEvent里用了写死的像素值或者用width()和height()分别算行列导致格子不是正方形。 解决取qMin(width(), height())作为基准边长行列都用同一个cell值。margin 也要参与计算side qMin(...) - margin*2再cell (side - margin*3)/4保证 4 格加 3 条缝正好铺满。4.5 现象换台电脑双击 exe 就报缺 dll原因只拷了 exe没拷 Qt 运行库。开发机上 Qt 在 PATH 里所以能跑别人机器上没有。 解决发布前跑windeployqt把整个输出目录打包。如果还报缺vcruntime之类那是 MSVC 运行库装 Microsoft Visual C Redistributable 即可MinGW 编译的则不需要。别把开发目录整个拷过去里面有一堆中间文件只拷 exe 加 windeployqt 生成的那几个文件夹。5. 让这份小工程再往前走一步加动画、存档和难度跑通之后这份 2048 还有不少能练手的空间而且每加一个功能都在逼你学一块新东西。最值得先做的是合并动画现在数字是瞬间跳变的加一个QPropertyAnimation或者用QVariantAnimation在 100~150 毫秒内插值格子位置和缩放观感立刻不一样。做法是给每个格子维护一个「显示值」和「目标值」paintEvent按当前插值画动画结束再对齐。这块会用到 Qt 的属性系统和定时器是理解 Qt 事件循环的好机会。第二个是存档。把grid序列化成 JSON 写进QSettings或本地文件启动时读回来。QSettings跨平台Windows 下写注册表Linux 下写配置文件代码不用改。存的时候连最高分一起存读的时候判一下文件是否存在不存在就新开一局。注意别在paintEvent里做 IO放到构造和move之后。第三个是难度和撤销。难度可以调初始格子数和出 4 的概率把tileVal(0,9)改成按难度取不同分布。撤销则需要保存历史棋盘用一个std::vector存每次移动前的快照按 CtrlZ 弹一个回来。内存占用很小4x4 的 int 数组一次才 64 字节存几百步也无所谓。功能涉及知识点大致工作量合并动画QPropertyAnimation、定时器半天存档读档QSettings、JSON两小时撤销栈、状态快照一小时难度选择参数化随机分布一小时我自己带人做这个项目时最常提醒的一句是先把move和slideLine用单元测试跑通再接界面。逻辑对了界面只是画出来逻辑错了你会以为是 Qt 的问题查半天发现是合并写错。当年我就是没测合并盯着paintEvent改了一晚上最后发现是slideLine少了个i。希望帮到你。本文还有配套的精品资源点击获取
