简介：面向 C++ 与 Qt4 初学者的 2048 小游戏实践包，以经典数字合并玩法为载体，帮助入门者理解面向对象编程、事件处理与图形界面设计，适合已掌握基础语法、希望完成一个小型 GUI 项目练手的学习者。项目围绕棋盘状态、数字方块和游戏流程展开，涉及 GameBoard、Tile、GameManager 等类的职责划分，并借助 Qt4 的 QGraphicsView、QGraphicsItem 实现界面绘制与动态效果，同时用信号与槽完成用户操作和逻辑响应，体现封装、继承与模块化组织思路。压缩包共 6 个文件，约 7KB，主要由 cpp、h、ui、pro 及 user 文件组成，分别对应核心逻辑、类声明、界面布局和工程配置，结构轻量，便于快速导入 Qt 环境阅读、调试并熟悉工程组织方式。已有 270 人学习，可作为课程设计、期末实践或自学练手素材，通过梳理棋盘合并规则、得分与结束判断、控件交互和自定义图形绘制，逐步形成从类设计到界面联调的完整练习路径。
1. 先把话说透：这份 2048 小游戏到底能让你学会什么
很多人第一次听到“用 C++ 写界面”这句话时，脑子里是没有画面的——课本上讲完变量、循环和数组，屏幕上还是那个黑底白字的控制台窗口，做完一道练习就不知道下一步该干嘛。这份 2048 小游戏初学资源正好卡在这个缺口上：它用 C++ 写游戏逻辑，用 Qt 做窗口和按键，把大家都玩过的那款 2048 做成一个能双击打开、能按方向键、能亲眼看着两个 2 合成一个 4 的桌面小程序。
它不要求你先啃完一本语法书，也不要求你懂什么设计模式或者架构分层。适合的人群很明确：学过一点 C++ 基础语法、能写 for 循环和数组、但从来没做出过一个“看得见”的程序的人。你要做的第一件事不是读懂每一行，而是让它先在你自己的电脑上跑起来。
2. 为什么新手别急着啃语法书：C++ 和 Qt 在这份代码里各干一半活
2.1 棋盘上那些数字，其实是 C++ 的活儿
把 2048 拆开看，它本质上就是一张 4 行 4 列的成绩单。每个格子里存一个数字，0 表示空，2、4、8、16 表示已经出现的方块。玩家按下方向键之后，程序要做的事情只有四件：把所有数字往一个方向挤、相邻且相等的两格合并成双倍、在空位随机补一个新数字、检查还有没有地方可走。
这四件事没有一件需要“界面”。它们全是数组遍历、条件判断和循环——也就是你课本上学过的那点东西。这份代码里，这部分通常会被单独放在一个类里，比如叫Game或者Board，对外只暴露几个函数：往左移、往右移、新开一局、当前得分多少、游戏是否结束。你把界面全部删掉，这部分代码照样能编译、能算出一个正确的结果，只是你看不见它。
我第一次学的时候，最有效的一步就是拿张纸把这 16 个格子画出来，然后手动模拟走一步：第 1 行是2 2 4 0，向左移之后应该变成4 4 0 0还是8 0 0 0？想清楚这个，你就理解了为什么代码里合并那一段要写“跳过刚合并出来的格子”——如果 2 和 2 合成了 4，紧接着又让这个 4 跟后面的 4 合并，玩家一按左键就直接从 2 跳到 8，这游戏就没法玩了。这种“一次移动只允许合并一轮”的规则，是后面读代码时最容易翻车的地方，也是最能训练你“把规则翻译成循环”的能力的地方。
所以别小看这 16 个格子。它让你第一次完整地经历“需求 → 数据结构 → 算法 → 边界情况”这条链路，而且每一步都能用眼睛验证对错：改一行代码，运行，看数字对不对。这种即时反馈，比做一百道纯计算题都管用。
2.2 你看到的窗口和按键，是 Qt 的活儿
如果说 C++ 负责“算什么”，那 Qt 负责的就是“让人看得见、点得着”。Qt 是一个跨平台的图形界面库，你用同一套代码，在 Windows 上编出来是个窗口程序，在另一套系统上编出来也是；它把创建窗口、画方块、接收键盘和鼠标、调用系统剪贴板这些事情都包好了，你只需要写“我的窗口长什么样”和“用户按了键我该干什么”。
这里有个概念新手一定要先建立起来，不然读代码会一直觉得别扭：Qt 程序不是“执行到 main 就结束”的，它跑起来之后会进入一个叫事件循环的东西，程序在那儿安静地待着，等系统告诉它“有人按了键盘”“有人点了关闭”“窗口需要重画了”，它再一条条派发出去。你写的那些函数不是自己按顺序执行的，而是被事件“叫醒”的。这就解释了为什么你明明写好了移动逻辑，界面却不动——因为没人通知界面去重画。
Qt 里还有一个说法叫“信号与槽”，听起来很玄学，其实就是“广播 + 订阅”。按钮被点击时不会直接去调用你的函数，它只是喊一嗓子“我被点了”，谁提前订阅了这声喊，谁就执行。好处是按钮完全不知道你的存在，你把按钮换成快捷键，逻辑一行都不用改。这份 2048 里，方向键的处理就走的是类似的路子，只是它接的是键盘事件而不是按钮点击。
关于版本，工程里常见的写法是QT += core gui，后面再跟一句greaterThan(QT_MAJOR_VERSION, 4): QT += widgets。这不是什么玄学咒语，而是在照顾老版本：qt4 那个年代，按钮、窗口这些类还都放在 gui 模块里；到了 Qt5 之后，它们被单独拆进了 widgets 模块，头文件的写法也从<QtGui/QWidget>变成了<QWidget>。你看到这段判断，说明这份代码是照着 qt4 的写法写的，又顺手让它在更新的版本上也能编过——这恰恰是新手最需要的样本，因为你在网上搜到的老教程、老问答，多半都是这种年代混着来的写法。
2.3 学完之后你手里会多出哪几样本事
不夸张地说，能独立把一个 2048 从源码跑到自己电脑上、并且改出一个自己的版本，你已经跨过了新手最难的那道坎：从“只能做命令行练习”变成“能交付一个别人双击就能玩的东西”。具体拿到手的，大概有这么几样。
第一是环境配置的经验。装编译器、装库、选工具链、处理路径和版本冲突，这些事听起来不体面，但它是所有桌面开发的入场券，早踩坑早省事。第二是读别人代码的习惯——你会知道先看工程配置文件，再看入口函数，最后才钻细节，而不是从第一行开始逐字读。第三是对“数据变了界面没变”这类问题的直觉，这在以后写任何界面程序时都会反复用到。第四是一个可以拿去改的项目骨架：想加分数显示、想加撤销一步、想换配色，都有地方下手，而不是面对一个空文件夹发呆。
3. 迈出第一步：把环境装好，让那个窗口先弹出来
3.1 三样东西要装齐：编译器、Qt 库、带插件的编辑器
新手最容易在这一步卡住，因为“装 Qt”这句话其实是三件事叠在一起。第一是编译器，它把.cpp文本翻译成机器能跑的程序，Windows 上常见的是随包附带的那个版本，另一套系统上通常是系统自带的；第二是 Qt 库本身，包括头文件、链接库，还有一个叫 qmake 的构建工具；第三是一个能看代码、能点“运行”的编辑器。
省事的做法是直接下载官方那个集成安装包，安装时勾选一个桌面版的编译套件，把“编辑器 + 编译器 + Qt 库”一次性装齐。版本上不用纠结，选一个长期支持版即可；如果你手头的资料特别强调 qt4，也不必特意去装十几年前的老版本，先用新版本跑，遇到编译不过的地方按第 5 章的清单改，通常就那么几处。
安装路径有个血泪经验：整条路径里不要出现中文和空格。像C:\Users\张三\我的文档\qt\这种路径，在编译阶段极易出现找不到文件、链接失败之类的怪问题，而且报错信息完全不会提示你“是路径的问题”，新手往往一查就是一下午。装之前先建一个D:\dev\qt这样的干净目录，能省掉后面 80% 的莫名错误。
提示：安装完成后，先别急着打开项目。从开始菜单启动一次编辑器，新建一个空白的窗口工程，点运行，看到那个灰色小窗口弹出来，再回去开 2048。这一步是在验证“环境本身没问题”，把环境问题和代码问题分开，排查起来才有方向。
3.2 从解压到第一次运行：按这个顺序点
拿到的是一个压缩包，先解压到一个纯英文路径下，比如D:\dev\game2048。解压后进去看一眼目录结构，你要找的是一个后缀为.pro的文件——它是这个工程的“说明书”，告诉构建工具这个项目叫什么、用到哪些模块、有哪些源文件。找到它，就等于找到了入口。
用编辑器打开的方式是“文件 → 打开文件或项目”，选中那个.pro，然后在弹出的配置页里勾选一个编译套件，点配置项目。接着按构建，再按运行。整个过程不需要你手写任何命令。
如果你更喜欢看命令行到底发生了什么，也可以在工程目录里手动走一遍，这样以后遇到问题时心里有底：
# 1. 进入解压后的工程目录，先确认 .pro 在哪一层 ls # 期望看到类似 game2048.pro、main.cpp、mainwindow.cpp 这样的文件 # 2. 生成 Makefile：qmake 会读 .pro 里的配置，翻译成编译规则 qmake game2048.pro # 3. 编译。Linux / macOS 用 make，Windows 下通常换成 mingw32-make make # 4. 运行。Windows 下是 game2048.exe，其余平台是 ./game2048 ./game2048逐行说一下这几条在干什么。第一条只是确认位置，如果ls出来只有一个文件夹，说明压缩包里还套了一层，得再进去一层。第二条的 qmake 是关键角色，它本身不编译代码，只负责把.pro里的QT += core gui这类描述翻译成一份 Makefile，也就是“先编哪个文件、链接哪个库”的施工单；所以只要.pro改过，就该重新跑一次 qmake。第三条才真正调用编译器，第一次跑会慢一些，因为所有文件都要从零编译。第四条运行，如果前面都过了但运行报错说找不到某个动态库，多半是库的路径没进系统环境变量，这种问题在集成编辑器里点运行是不会出现的，这也是为什么建议新手先用编辑器跑通。
跑起来之后你应该看到：一个固定大小的窗口，中间是一片方格，里面零散分布着两三个数字。按方向键，数字整体移动，相同的两格合成一个，同时空位冒出一个新的 2 或 4。看到这一幕，环境这一关就算过了。
3.3 编译失败时，先看报错的第一行而不是最后一行
第一次编译大概率不会一次过，这很正常，别慌。新手看报错最常见的错误是从下往上读，结果被最后那几十行吓到——其实编译器在遇到第一个无法理解的语句时就会放弃后续分析，后面那些“未定义引用”“找不到符号”，十有八九是第一个错误的连锁反应。
正确的看法是：从上往下找第一条带error的行（注意不是warning，警告可以先放着），看它指向哪个文件第几行，再看那句话到底缺了什么。如果提示是“找不到某个头文件”，九成是模块没在.pro里声明，或者那个类在新版本里换了位置；如果提示是“未定义的引用”，说明头文件找到了但库没链上，看.pro里QT +=那一行少写了什么。把第一条错误解决掉，重新编译，往往后面一大片就自己消失了。
另一种常见情况是编译全过，但运行时窗口一闪就没了。这不是代码写错，通常是程序在启动阶段就崩了或者提前退出，用编辑器的调试模式跑一次，它会停在出错的那一行，比任何猜测都快。
4. 跟着跑通第一个例子：从按下方向键到两个 2 合成 4
4.1 先看 .pro：一个工程是怎么被“交代”清楚的
.pro文件很短，但它决定了后面所有事情，所以值得先花五分钟看懂。典型内容长这样：
# 声明要用到的 Qt 模块：core 是基础工具类，gui 是图形相关 QT += core gui # qt4 里控件类在 gui 模块中；Qt5 之后被拆到 widgets，这行是兼容写法 greaterThan(QT_MAJOR_VERSION, 4): QT += widgets # 生成的可执行文件名，不要带中文和空格 TARGET = game2048 # 告诉 qmake 这是一个应用程序而不是库 TEMPLATE = app # 参与编译的源文件，反斜杠表示"这一行还没完" SOURCES += main.cpp \ mainwindow.cpp \ game.cpp # 对应的头文件 HEADERS += mainwindow.h \ game.h这里每一条都能和后面的报错对上号。QT +=少了 widgets，编译时就会在#include <QWidget>那一行报找不到文件；SOURCES里漏了一个.cpp，链接时就会报某个函数“未定义的引用”——因为声明在头文件里，实现却没被编进去。所以我一般建议新手在动手改代码之前，先核对这三件事：模块齐不齐、源文件列全没列全、目标名是不是纯英文。这三件事对了，剩下的问题就都落在代码本身，范围一下子缩小很多。
还有一个小细节：如果你新增了一个.cpp文件却忘了往SOURCES里加，编辑器可能不报错（它自己能找到），但一构建就失败。这种“编辑器里看着好好的，一编译就崩”的落差，是新手最容易被劝退的瞬间之一，记住这条就不用怕。
4.2 棋盘为什么是 4×4 的二维数组
打开游戏逻辑那个类，你会看到棋盘基本就是这么声明的：
// 4 行 4 列，0 表示空格，其他值直接存方块上的数字 int board[4][4]; // 当前得分，合并成功时累加 int score;用二维数组而不是 16 个变量，理由很实在：移动和合并都是“按行”或“按列”批量处理的，二维数组让“取第 i 行”这件事变成一次循环，代码短、也不容易写错。同一份合并逻辑，上下左右四个方向都能复用——向左移就是逐行合并，向上移就是逐列合并，向右和向下只是把结果反过来放。
这里有个新手常犯的错：把“棋盘坐标”和“屏幕坐标”搞混。数组里的board[0][0]是左上角那一格，而界面绘制时y轴是往下增大的，两者如果对应错了，就会出现“按左键数字往上跑”这种灵异现象。排查方法很土但有效：在绘制函数里把每个格子的行列号打印出来，对照屏幕看一眼就明白了。
再往下，你会看到“在空位随机生成一个新数字”的实现。它通常是先遍历所有格子把空位收集到一个列表里，再从列表里随机挑一个。别小看这一步，如果直接随机行列号再判断是不是空，格子快满的时候会陷入反复重试，极端情况下一次生成能卡顿好几帧。收集空位再随机，是这个游戏里最值得抄走的一个小套路。
4.3 合并算法：一行数字怎么往左挤
这是整份代码里最值得逐行读的一段。我们只看“一行向左合并”，其他三个方向都是它的变体：
// 把一行 4 个格子向左挤压并合并，返回这一次得到的分数 int mergeRowLeft(int row[4]) { int gained = 0; int tmp[4] = {0, 0, 0, 0}; int k = 0; // 第一步：把所有非 0 的数字按原顺序挤到前面 // 例如 2 0 2 4 变成 2 2 4 0，空位全部甩到后面 for (int i = 0; i < 4; ++i) { if (row[i] != 0) { tmp[k++] = row[i]; } } // 第二步：从左往右扫，相邻相等就合并 for (int i = 0; i < 3; ++i) { if (tmp[i] != 0 && tmp[i] == tmp[i + 1]) { tmp[i] *= 2; // 合并成双倍 gained += tmp[i]; // 顺手记分 tmp[i + 1] = 0; // 被吃掉的那格清空 ++i; // 关键：跳过刚生成的格子，防止连锁合并 } } // 第三步：把合并后留下的空位再挤一次，尾部补齐 0 k = 0; for (int i = 0; i < 4; ++i) { if (tmp[i] != 0) { row[k++] = tmp[i]; } } while (k < 4) { row[k++] = 0; } return gained; }三步走，每一步都能用纸笔验证。第一步解决“中间有空格”的问题——2 0 2 4如果不先挤压，直接比较相邻两格就永远合不上。第二步是核心，++i那一行是最容易漏的：如果 2 2 4 0 向左移，先合成 4 得到4 0 4 0，此时如果不跳过，循环的下一次又会拿这个新 4 去和后面的 4 比较，再合成 8，一按左键数字直接翻两级，玩家会觉得这游戏坏了。第三步是收尾，因为第二步结束后数组中间可能还有空洞。
注意tmp[i] != 0这个判断：不加它，两个空格（0 和 0）也会被判成“相等”从而“合并”，虽然结果还是 0 看不出来，但分数统计会莫名其妙多出来一堆。这种“空值参与运算”的坑，在任何涉及合并的逻辑里都要防一手。
四个方向的复用方式是：向左直接把每一行丢进去；向右先把每行反转，合并完再反转回来；向上和向下则先做一次行列转置，把列变成行，处理完再转置回去。转置那几行代码看着绕，其实就是在交换board[i][j]和board[j][i]，写一次就够用一辈子。
4.4 按键怎么就传到了你的函数里
逻辑写好了，还得有人触发它。窗口类里通常会有这么一段：
// 构造函数里：让窗口能接收键盘事件，不设的话方向键按了没反应 MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) { setFocusPolicy(Qt::StrongFocus); } // 重写键盘事件处理函数，系统会把每次按键都送进来 void MainWindow::keyPressEvent(QKeyEvent *event) { switch (event->key()) { case Qt::Key_Left: game.moveLeft(); break; case Qt::Key_Right: game.moveRight(); break; case Qt::Key_Up: game.moveUp(); break; case Qt::Key_Down: game.moveDown(); break; default: return; // 其他键不处理，交回父类默认行为更稳妥 } update(); // 数据变了，通知界面重画 }这段代码体现的正是前面说的“事件驱动”：keyPressEvent不是你主动调用的，是系统在用户按键时替你调用的。event->key()返回的是键值常量，用switch分发到四个方向，比一串if-else好读。default分支里直接返回，是为了不吞掉其他按键——比如用户按 Esc 想关窗口，你如果也拦下来，窗口就关不掉了。
最容易被忽略的是构造函数里那句setFocusPolicy。没有它，窗口不接收键盘焦点，你按什么都没反应，代码看着完全正确，运行起来就是不动——这是新手排查时间最长的问题之一。
4.5 画面为什么不会自己刷新
很多人改完数据发现界面纹丝不动，就以为逻辑错了，其实是差最后一步。界面上的方块不是在数据变化时自动更新的，它是在系统认为“这块区域需要重画”时，调用你写的绘制函数。所以移动之后必须调一次update()，相当于跟系统说“我这块脏了，你找时间重画一下”。
绘制函数里做的事情很直白：遍历 16 个格子，根据数值决定画什么颜色、写什么字。数值到颜色通常用一组if-else或者一张查找表搞定，没必要搞复杂。这里有个小技巧：把“数值 → 颜色”做成一张表，以后想换配色只改表，不用碰绘制逻辑。
5. 新手最容易翻车的五个地方：一份排查清单
5.1 环境和工程类的坑
第一个坑：双击.pro文件打不开，系统提示没有关联程序。现象是文件图标是白的，双击弹出一个“如何打开”的对话框。原因是.pro只是普通文本文件，系统并不知道该用编辑器打开它。解决办法是别双击，先启动编辑器，从“文件 → 打开文件或项目”里选中它；如果你装了多个版本的编辑器，注意别用错版本打开，否则配置页里可能找不到可用的编译套件。
第二个坑：编译报一堆“找不到某个控件头文件”。现象是错误集中在#include那几行，提示某个类不存在。原因基本是版本差异——老写法把控件放在 gui 模块里，新版本拆进了 widgets，而.pro里没有补上QT += widgets。解决办法是先在.pro的QT +=那一行补上 widgets，重新跑一次 qmake 再编译；如果还有零星几个头文件报错，把它们改成<QWidget>这种不带模块前缀的写法。别一次改十几个文件，改一个编一次，才知道是哪一处起了作用。
5.2 跑起来但“不对劲”的坑
第三个坑：窗口出来了，按方向键完全没反应。现象是鼠标点一下窗口再按也没用，数字一动不动。原因多半是窗口没有接收键盘焦点，或者事件处理函数根本没被重写。解决办法是确认构造函数里有setFocusPolicy(Qt::StrongFocus)，并且keyPressEvent的签名和父类完全一致——少个参数、多个const，编译器都不会报错，但它就是不会被调用，这类问题只能靠对照头文件核对。
第四个坑：数字确实合了，但屏幕不变，鼠标拖动一下窗口才刷新。现象是新数字在窗口被遮挡或移动后才出现。原因就是移动之后忘了通知重画。解决办法是在每次移动逻辑执行完之后调一次update()；如果嫌每次都写麻烦，也可以在移动函数末尾统一调，但要注意别在绘制函数里调update()，那会陷入无限重绘，程序直接卡死。
第五个坑：一次移动数字连跳两级，比如2 2 4 0一按左键直接变成 8。现象是分数涨得离谱，玩家一次操作能拿双倍分。原因就是合并循环里忘了跳过刚生成的格子。解决办法是在合并成功后让循环下标额外加一，跳过下一格；改完之后拿几个典型行手动验一遍：2 2 2 2应该变成4 4 0 0，4 4 8 0应该变成8 8 0 0，2 2 4 0应该变成4 4 0 0而不是8 0 0 0。这三组过了，合并逻辑基本就没问题。
6. 跑通之后别急着换项目：把 2048 改出你自己的版本
一个能跑的示例最大的价值，不是“我跑通了”，而是“我可以拿它练手”。跑通之后立刻换下一个项目，是最常见的浪费——你只是重复了一遍配置环境，代码一行没往脑子里去。更好的做法是留在这个项目上，按难度从低到高改几处，每改一处都重新编译、重新玩一局，用眼睛验证对错。
下面这张表可以当成你的练习清单，从上往下做，基本不用查资料就能完成前两项。
| 想练什么 | 从哪里下手 | 难度 |
|---|---|---|
| 熟悉界面改动 | 改绘制函数里的颜色和字号 | 低 |
| 熟悉数据流 | 在窗口顶部加一个实时分数标签 | 低 |
| 熟悉事件处理 | 加一个“重新开始”按钮并接上信号 | 中 |
| 熟悉状态管理 | 记录上一步棋盘，做一次撤销 | 中 |
| 熟悉算法 | 把 4×4 改成 5×5，检查合并逻辑是否还成立 | 高 |
第一项改颜色，看着最简单，但它逼你去看绘制函数是怎么把数值映射成颜色的，看完你就知道界面这一层是怎么组织的。第二项加分数标签，会让你遇到“数据在逻辑类里、标签在界面类里，两者怎么通信”这个问题，这正是信号与槽最典型的用途：逻辑类算完分之后发一个信号，界面类收到就把标签文字改掉，两边谁都不用认识谁。第三项加按钮，是信号与槽最入门的形态，一个连接语句就能搞定，但它能让你彻底理解“广播 + 订阅”这套思路。
往后两项就开始有意思了。做撤销，你需要保存上一步的完整棋盘和分数，这里会自然引出“我该在什么时候存快照”的问题——答案是在每次有效移动之前存，而不是之后，否则撤销回来的是已经动过的局面。把 4×4 改成 5×5，听起来只是把数字从 4 换成 5，实际动手你会发现代码里可能有好几处硬编码的 4：循环上界、数组声明、随机数范围、绘制时的格子宽高计算。把这些 4 全部抽成一个常量，是这次练习真正的收获——它让你第一次体会到“为什么老手总说要消灭魔法数字”。
我自己的习惯是：每拿到一个能跑的示例，强制自己先改三个地方再去碰别的项目——改一个显示效果、加一个交互入口、动一处核心逻辑。三个改完，这个项目才算真的进过我脑子，而不是在硬盘上存了一份。第一次跑通一个带窗口的程序时我兴奋了大概十分钟，然后就卡住了，不知道该往下改什么，那种感觉比报错还难受；从那以后我每次都会先把“接下来改哪三处”写在纸上，再动手。希望帮到你。
本文还有配套的精品资源，点击获取
