简介这是一份面向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 说起Qt 做小游戏到底能学到什么很多人第一次接触 Qt都是从一份 2048qt小游戏C初学.zip 这样的压缩包开始的。解压出来几个 .h、几个 .cpp、一个 .pro双击 .pro 用 Qt Creator 打开点一下绿色三角一个能玩的 2048 就出来了。看起来很简单但真正动手改的时候问题就来了格子怎么画上去的键盘事件怎么接的为什么我改了颜色整个界面就花了这份代码到底值不值得拿来当 C 和 Qt 的入门项目我的判断是值得但前提是你不能只满足于“能跑”。2048 这个游戏麻雀虽小五脏俱全——它同时覆盖了 C 基础语法数组、类、随机数、字符串处理、Qt 核心机制信号槽、事件循环、QPainter 绘图、QWidget 布局以及一个完整小项目该有的结构模型与视图分离、状态管理、重开逻辑。对初学者来说它比贪吃蛇多一层二维网格逻辑比计算器多一层动画和交互是少有的“难度刚好卡在舒适区边缘”的练手项目。这篇文章不假设你手里有某一份特定的源码而是按“一份典型的 Qt 版 2048 工程”来拆它一般由哪些文件组成、核心逻辑怎么写、Qt 的信号槽和绘图怎么接进去、编译和发布时会踩哪些坑。新手可以照着一步步复现熟手可以直接跳到参数和避坑部分看看自己的实现有没有埋雷。2. 拆开一份 Qt 2048 工程文件结构、核心类与信号槽怎么落地2.1 一个能跑的 Qt 2048 通常有哪几个文件一份结构清晰的 Qt 2048 工程文件数量不会太多但职责要分明。常见做法是拆成下面这几类文件职责典型内容main.cpp程序入口创建 QApplication实例化主窗口进入事件循环mainwindow.h/.cpp主窗口与界面继承 QWidget重写 paintEvent、keyPressEvent持有游戏逻辑对象game.h/.cpp游戏核心逻辑4x4 网格数据、移动合并算法、随机生成新格子、胜负判断game.proqmake 工程文件QT widgetsSOURCES/HEADERS 列表resources.qrc资源文件可选字体、图标、样式表有些版本会把逻辑全部塞进 MainWindow代码量看着少但改起来很痛苦。我一般会坚持把Game类独立出来它不依赖任何 Qt 界面头文件只用一个int board[4][4]或者std::arraystd::arrayint,4,4存数据。这样做的直接好处是你可以在控制台里单独测试移动合并逻辑不用每次都启动图形界面。Game类对外暴露的接口通常长这样// game.h class Game { public: Game(); void reset(); // 重开一局 bool move(int direction); // 0上 1右 2下 3左返回是否发生有效移动 int at(int row, int col) const; // 读取格子数值 bool isGameOver() const; // 是否无路可走 bool hasWon() const; // 是否出现 2048 int score() const; // 当前得分 private: std::arraystd::arrayint,4,4 board; int currentScore; void addRandomTile(); // 在空位随机放 2 或 4 bool slideLine(std::arrayint,4 line, int gained); // 单行/单列合并 };这里的关键设计是slideLine把二维移动拆成“取出一行/一列 → 压缩 → 合并 → 再压缩 → 写回”。四个方向只是取行取列的方式不同核心算法只有一份。这是 2048 逻辑里最值得反复看的部分也是面试里手写代码的高频题。2.2 信号槽在 2048 里到底用在哪很多初学者学 Qt 信号槽看的例子都是“按钮点击 → 弹窗”放到 2048 里就不知道往哪接了。实际上 2048 的信号槽可以很自然地用在两个地方第一键盘事件到游戏逻辑。主窗口重写keyPressEvent根据按键调用game.move()如果返回 true就update()触发重绘同时检查胜负。这里不一定非要用自定义信号但如果你想把“得分变化”通知给一个独立的分数标签就可以在 MainWindow 里定义一个scoreChanged(int)信号连接到 QLabel 的setNum槽。第二重开按钮。界面上放一个 QPushButton点击后调用game.reset()并刷新界面。用connect(restartBtn, QPushButton::clicked, this, MainWindow::restartGame)一行接好这就是信号槽最典型的用法。// mainwindow.cpp 片段 connect(restartBtn, QPushButton::clicked, this, MainWindow::restartGame); connect(this, MainWindow::scoreChanged, scoreLabel, QOverloadint::of(QLabel::setNum)); void MainWindow::keyPressEvent(QKeyEvent *event) { int dir -1; switch (event-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(event); return; } if (game.move(dir)) { update(); // 触发 paintEvent emit scoreChanged(game.score()); if (game.isGameOver()) { /* 弹出结束提示 */ } } }参数说明QOverloadint::of(QLabel::setNum)是因为setNum有多个重载版本不写清楚编译器不知道连哪个。这是 Qt5 之后新语法里常见的坑用旧式SIGNAL/SLOT宏反而不会遇到但新语法类型安全更好值得习惯。2.3 用 QPainter 把 4x4 网格画出来2048 的界面不复杂但用 QPainter 手绘比用 QGridLayout 摆 16 个 QLabel 更常见因为格子颜色和数字要随状态变化手绘更灵活。核心在paintEvent里void MainWindow::paintEvent(QPaintEvent *) { QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing); int margin 10, cell 80, gap 10; for (int r 0; r 4; r) { for (int c 0; c 4; c) { QRect rect(margin c * (cell gap), margin r * (cell gap), cell, cell); int val game.at(r, c); painter.setBrush(colorForValue(val)); // 按数值取背景色 painter.setPen(Qt::NoPen); painter.drawRoundedRect(rect, 6, 6); if (val 0) { painter.setPen(val 4 ? Qt::black : Qt::white); QFont font painter.font(); font.setPixelSize(val 100 ? 32 : (val 1000 ? 26 : 20)); font.setBold(true); painter.setFont(font); painter.drawText(rect, Qt::AlignCenter, QString::number(val)); } } } }逻辑说明colorForValue是一个辅助函数用 switch 或查表返回不同数值对应的 QColor。字体大小随位数递减是为了防止 1024、2048 这种四位数溢出格子。drawRoundedRect的圆角半径 6 是经验值太大显得圆润过头太小又像方块。这些参数没有标准答案但改的时候要保证格子间距和窗口大小匹配否则会出现格子被裁掉或者留白过多。提示如果窗口大小固定记得在构造函数里调用setFixedSize()否则用户拉伸窗口后手绘坐标不会自适应界面会错位。想支持缩放就要把 cell 和 margin 改成根据width()、height()动态计算。3. 从零复现核心逻辑移动合并算法、随机数与键盘事件3.1 移动合并一行代码写错就全盘皆输2048 最容易写错的地方就是合并规则。正确规则是同一行里先压缩掉空格然后从左到右相邻且相等的两个数合并成一个且每个格子一回合只能合并一次。很多人写成循环里边遍历边合并结果[2,2,2,2]被合并成[8]而不是[4,4]。稳妥的做法是把一行单独拿出来处理bool Game::slideLine(std::arrayint,4 line, int gained) { std::arrayint,4 result {0,0,0,0}; int pos 0; // 第一步压缩把所有非零数移到前面 for (int i 0; i 4; i) { if (line[i] ! 0) result[pos] line[i]; } // 第二步合并相邻相等项 for (int i 0; i 3; i) { if (result[i] ! 0 result[i] result[i1]) { result[i] * 2; gained result[i]; result[i1] 0; i; // 跳过下一个防止连锁合并 } } // 第三步再次压缩填补合并产生的空位 std::arrayint,4 finalLine {0,0,0,0}; pos 0; for (int i 0; i 4; i) { if (result[i] ! 0) finalLine[pos] result[i]; } bool changed (finalLine ! line); line finalLine; return changed; }参数说明gained是引用传出参数累计本次移动获得的分数。i那一步是防止[2,2,4]在合并出[4,4]后又被继续合并成[8]。这个细节如果漏掉游戏难度会骤降玩家很快就能刷出 2048但逻辑是错的。四个方向的移动只是取行取列的方式不同。向上移动时把每一列当作一行传给slideLine处理完再写回向下移动时把列反转后再处理。写一个move(int direction)统一调度代码不会超过 40 行。3.2 随机数为什么你的新格子总是出现在同一个位置Qt 里生成随机数常见做法是qsrand(QTime::currentTime().msec())配合qrand()或者用 C11 的random。问题在于如果你在每次addRandomTile里都重新播种或者用rand() % 16直接取模会出现两个毛病一是随机性差新格子位置有规律二是如果空位列表没维护好可能覆盖已有数字。我一般会这样做void Game::addRandomTile() { std::vectorstd::pairint,int empty; for (int r 0; r 4; r) for (int c 0; c 4; c) if (board[r][c] 0) empty.emplace_back(r, c); if (empty.empty()) return; static std::mt19937 gen(std::random_device{}()); std::uniform_int_distribution posDist(0, empty.size() - 1); std::uniform_int_distribution valDist(1, 10); auto [r, c] empty[posDist(gen)]; board[r][c] (valDist(gen) 1) ? 4 : 2; // 10% 概率出 4 }逻辑说明先收集所有空位再从空位里随机选一个保证不会覆盖已有数字。static std::mt19937只初始化一次避免每次调用都重新播种。valDist(1,10)取 1 时出 4其余出 2这样 4 的出现概率约 10%和原版 2048 的手感接近。如果你用qrand() % empty.size()在空位数量变化时分布会偏这是很多人觉得“随机数不随机”的根源。3.3 键盘事件与焦点为什么按了方向键没反应keyPressEvent不触发九成是焦点问题。QWidget 默认不接收键盘焦点需要在构造函数里设置setFocusPolicy(Qt::StrongFocus);如果主窗口里放了按钮或其他控件它们可能抢走焦点。这时候要么给按钮设置setFocusPolicy(Qt::NoFocus)要么在主窗口里重写keyPressEvent后调用event-accept()确保事件不被继续传递。还有一种情况是用了 QMainWindow 而不是 QWidget菜单栏或状态栏可能拦截按键需要确认事件过滤链。另外方向键在 Qt 里默认可能被用于焦点切换。如果你发现按左右键时焦点在按钮之间跳而不是控制游戏就是这个问题。解决办法是在keyPressEvent里对方向键显式处理并accept()不要调用父类的实现。4. 编译、发布与跨平台qmake 工程最常见的翻车点4.1 .pro 文件写不对编译第一步就卡住一份典型的 2048 工程.pro文件通常只有几行但少一行就报错QT widgets CONFIG c11 TARGET game2048 TEMPLATE app SOURCES main.cpp mainwindow.cpp game.cpp HEADERS mainwindow.h game.h参数说明QT widgets是必须的Qt5 之后 widgets 模块不再默认包含。如果用了QPainter、QKeyEvent却只写QT core编译会报找不到头文件。CONFIG c11是为了用std::array、std::mt19937这些特性Qt5 默认可能还是 C98。如果你在代码里用了auto [r, c]这种结构化绑定需要CONFIG c17。常见报错cannot find -lpublic或unknown module(s) in QT: webenginewidgets基本都是.pro里写了当前 Qt 版本没有的模块。2048 用不到 webengine如果从网上抄了一份带QT webenginewidgets的工程删掉那一行即可。4.2 中文乱码源码编码和运行环境要对齐Qt Creator 默认用 UTF-8 保存源文件但 Windows 控制台和某些编译器可能按 GBK 解释。如果你在代码里写了中文字符串比如setWindowTitle(2048小游戏)运行时可能显示乱码。稳妥做法是在main.cpp里设置编码#if QT_VERSION QT_VERSION_CHECK(6,0,0) QTextCodec::setCodecForLocale(QTextCodec::codecForName(UTF-8)); #endif或者在.pro里加QMAKE_CXXFLAGS -utf-8MSVC。更彻底的办法是源文件保存为带 BOM 的 UTF-8MSVC 能正确识别。Qt6 之后 QTextCodec 移到了 core5compat 模块如果用的是 Qt6要么改用QString::fromUtf8要么把中文都放在资源文件里。4.3 发布时缺 DLL双击 exe 提示找不到 Qt5Core.dll用 Qt Creator 跑得好好的把 exe 拷到别的电脑就报缺 DLL这是发布环节的经典问题。Qt 提供了windeployqt工具在命令行里执行windeployqt game2048.exe --release它会把依赖的 Qt5Core.dll、Qt5Gui.dll、Qt5Widgets.dll 以及 platforms/qwindows.dll 拷到 exe 同目录。注意platforms文件夹必须存在否则会报could not find the Qt platform plugin windows。如果目标机器没有安装 Visual C Redistributable还需要把msvcp140.dll、vcruntime140.dll一起带上或者让用户安装对应的 redistributable 包。注意Debug 版 exe 依赖的是 Qt5Cored.dll 等带 d 后缀的库发布时要用 Release 版重新编译否则体积大且可能缺库。5. 避坑与排查2048 小游戏里那些让人抓狂的瞬间5.1 现象游戏能跑但按方向键格子不动原因主窗口没有设置焦点策略或者焦点被按钮抢走。keyPressEvent根本没被调用。解决构造函数里加setFocusPolicy(Qt::StrongFocus)按钮加setFocusPolicy(Qt::NoFocus)。在keyPressEvent里加一行qDebug() key pressed确认是否进入。如果没进入检查是否误用了QMainWindow且没有设置 central widget。5.2 现象合并逻辑偶尔出错出现不该有的数值原因slideLine里合并后没有跳过下一个元素导致连锁合并。或者四个方向的取行取列写反了向下移动实际执行了向上。解决用固定用例测试。构造[2,2,2,2]正确结果应是[4,4,0,0]得分 8。构造[2,2,4]正确结果[4,4,0]得分 4。把slideLine单独拿出来写单元测试比在界面里反复试快得多。5.3 现象新格子出现在已有数字上或者位置明显有规律原因随机数种子每次重新播种或者用rand() % 16直接取模而没有排除非空位。解决用std::mt19937静态初始化一次先收集空位列表再随机选。不要用qsrand在循环里反复调用。5.4 现象窗口拉伸后格子错位、数字溢出原因paintEvent里用了固定坐标和固定字体大小没有根据窗口尺寸动态计算。解决要么setFixedSize()锁死窗口要么在paintEvent里用width()、height()计算 cell 大小并根据 cell 大小动态设置字体像素。字体大小可以用cell * 0.4这样的比例来算保证不同尺寸下观感一致。5.5 现象Release 版正常Debug 版闪退报 0xc0000005原因访问了未初始化的指针或数组越界。2048 里常见于board[r][c]的 r、c 越界或者empty列表为空时仍然取随机位置。解决在at()和addRandomTile()里加断言Q_ASSERT(r 0 r 4)。用 Qt Creator 的调试器看崩溃时的调用栈定位到具体行。Release 版因为优化可能掩盖问题不要只测 Release。6. 进阶技巧把 2048 改成你自己的练手平台一份 2048qt小游戏C初学.zip 跑通之后真正的价值在于把它当成试验田。我自己的习惯是每学一个新东西就试着往这个项目里加一点看能不能跑通。第一个方向是动画。原版 2048 的格子是瞬间跳变的你可以用QPropertyAnimation给格子位置和数值变化加过渡。做法是把每个格子的绘制坐标做成一个可动画的属性移动时先更新逻辑再启动动画动画结束后重绘。这会逼你理解 Qt 的属性系统和动画框架比看文档印象深得多。第二个方向是存档。用QJsonDocument把board、score、isGameOver序列化成 JSON存到QStandardPaths::AppDataLocation目录下。启动时读取实现“关掉再打开还能继续”。这个过程中你会接触到 Qt 的文件路径处理、JSON 读写和错误处理都是实际项目里天天用的。第三个方向是换皮。把colorForValue改成从配置文件读取支持多套配色把数字换成图片或自定义字体。这能让你熟悉QResource、QSettings和样式表。如果想让界面更现代可以试试 Qt Quick 重写界面逻辑层Game类完全不用动这就是当初把逻辑和界面分开的好处。验证你的实现是否正确有一个简单办法写一个控制台版本的main不启动 GUI直接调用Game的move和at用固定种子跑 1000 步检查分数和棋盘状态是否符合预期。能通过这个测试界面层再怎么改都不会影响核心逻辑。我踩过最深的一个坑是早期把Game对象直接嵌在 MainWindow 里后来想加动画发现逻辑和绘制缠在一起改一处崩三处。后来强制自己把Game写成不依赖 Qt 的纯 C 类才真正体会到分层的价值。如果你刚开始写哪怕多花半小时拆文件后面会省下好几倍的调试时间。希望帮到你。本文还有配套的精品资源点击获取