简介这份基于 Qt 与 C 的简略版贪吃蛇项目面向希望借小型案例理解图形界面与游戏循环的 Qt 初学者及 C 练习者重点示范从窗口搭建、对象组织到碰撞检测、计分和结束判定的完整实现思路。压缩包共 8 个文件、约 209KB以 2 个 cpp 源文件和 1 个 h 头文件承载主窗口与核心逻辑配合 1 个 ui 界面文件、1 个 pro 工程文件、1 个 user 配置及 2 张 jpg 效果图便于直接查看工程结构与运行界面。已有 264 人学习适合按 Qt 工程方式打开研究也方便对照效果图快速定位界面与逻辑入口。代码整体围绕 QGraphicsView/Scene 组织蛇、食物和边界对象涉及键盘方向控制、定时器驱动移动、碰撞检测、蛇身增长、食物重生成、分数更新并体现类职责划分和信号槽协作可作为课程设计、Qt 入门练习或小型游戏原型参考。1. 三百行代码的 QT 贪吃蛇小到能一口气读完大到能把 Qt 三大机制都摸一遍一个基于 QT 和 C 的简略版贪吃蛇游戏代码量通常只有三四百行却能把 Qt 里最常打交道的三套机制全部走一遍QWidget 自绘、QTimer 驱动的游戏循环、键盘事件分发。它不依赖任何第三方库不用图片素材一个qmake就能编出来对刚摸 Qt 的人特别友好——你能在一晚上读完所有源码而不是淹没在框架里。它适合三类人第一类是想把 Qt 的paintEvent、keyPressEvent、信号槽真正用一遍而不是只看文档的新手第二类是手里有课程作业或小 Demo 需求想要一个结构干净、能直接往上加功能的底座第三类是老手拿它当“最小可复现样本”验证某个 Qt 版本的编译链、打包流程是否通。不适合的也很明确想要物理引擎、粒子效果、关卡编辑器的这份简略版给不了它刻意砍掉了所有非核心的东西。2. 项目骨架与技术选型QWidget 自绘 QTimer 驱动为什么不用 QGraphicsScene先看一个数字对比。用 QLabel 拼棋盘的做法24×20 的格子就是 480 个控件对象每一帧都要改几百个setStyleSheetQt 的样式表解析开销会直接把帧率拖垮用 QGraphicsScene 则要引入 scene、view、item 三层坐标对一个只有“蛇 食物”两个元素的游戏属于明显的过度设计。简略版选择的是第三条路一个QWidget子类所有东西都在paintEvent里用QPainter画出来。这是这类小游戏里最常见、也是最省心的做法。2.1 目录结构与文件职责标准形态只有五个文件Qt Creator 直接打开.pro就能跑snake_qt/ ├── snake_qt.pro # qmake 工程文件Qt Creator 双击即开 ├── CMakeLists.txt # 备用构建脚本给命令行或 CI 用 ├── main.cpp # 只有 QApplication show不放任何游戏逻辑 ├── gamewidget.h # 类声明蛇身容器、方向、计时器、状态位 └── gamewidget.cpp # 全部实现reset / tick / paint / keyPressmain.cpp保持极简是这个结构的第一个约定游戏逻辑一行都不要往main里塞。因为后面你想把GameWidget塞进一个带菜单栏的QMainWindow、或者塞进一个 Tab 页里时main.cpp不需要改。gamewidget.h里只放声明和那几个static constexpr常量格子边长、列数、行数、初始速度所有魔法数字集中在一处改棋盘大小只动这几行。文件拆到这个粒度就够了别一上来就搞Snake类、Food类、Board类、GameEngine类四五个文件——简略版的蛇身就是一个std::dequeQPoint食物就是一个QPoint为它们各建一个类纯属给自己找事。等到第 6 章要写测试了再拆不迟。2.2 为什么是 QWidget 自绘而不是 QGraphicsScene关键差别在“谁帮你管重绘”。QGraphicsScene的优势是大量 item 的局部刷新和碰撞查询贪吃蛇每一帧蛇身都在整体位移绝大多数格子都要重画局部刷新带来的收益接近零反而要为每个 item 维护 scene 坐标和 view 坐标的换算。QWidget自绘的逻辑非常直白update()触发一次paintEvent你在里面按格子坐标从头画一遍。格子坐标和像素坐标的换算只有一个乘法p.x() * kCell没有第二套坐标系出 bug 时肉眼就能对出来。代价也很清楚窗口一拉伸如果你的绘制代码里混用了width()和固定kCell画面立刻错位。所以构造函数里那句setFixedSize(kCols * kCell, kRows * kCell)不是可选项而是这套方案的前提——棋盘尺寸固定坐标系才固定。2.3 .pro 与 CMakeLists 两套构建配置Qt Creator 认.pro命令行和 CI 更认 CMake两个都留着不冲突QT core gui widgets CONFIG c17 TEMPLATE app TARGET snake_qt SOURCES main.cpp gamewidget.cpp HEADERS gamewidget.h这里最容易漏的是widgets。Qt 4 时代QT gui就够了Qt 5 把 widgets 拆成了独立模块只写core gui会在#include QWidget那一行直接报找不到头文件。CONFIG c17也不是摆设std::deque、constexpr、结构化绑定这些都用得上默认标准可能是 C11。CMake 版本对应cmake_minimum_required(VERSION 3.16) project(snake_qt LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) set(CMAKE_AUTOMOC ON) # 类里有 Q_OBJECT必须开否则链接期报 vtable 未定义 find_package(QT NAMES Qt6 Qt5 REQUIRED COMPONENTS Widgets) find_package(Qt${QT_VERSION_MAJOR} REQUIRED COMPONENTS Widgets) add_executable(snake_qt main.cpp gamewidget.cpp gamewidget.h) target_link_libraries(snake_qt PRIVATE Qt${QT_VERSION_MAJOR}::Widgets)CMAKE_AUTOMOC ON和Q_OBJECT是绑定关系。只要类里写了Q_OBJECT宏用了信号槽就必须写moc 就要生成moc_xxx.cppCMake 不开 AUTOMOC 就会在链接阶段报一堆undefined reference to vtable for GameWidget。这个错误信息极具误导性新手很容易怀疑是析构函数写错了其实是构建系统没跑 moc。提示.pro和CMakeLists.txt别同时维护太久功能加多了容易两边不同步最后只在一边能编过。2.4 游戏状态机的三个状态简略版常用两个boolm_over和m_paused。能跑但组合出四种状态其中“既结束又暂停”是不合法的靠代码自觉去避免。稍微讲究一点会写成枚举enum class GameState { Running, Paused, Over };三态的好处是tick()开头一句if (m_state ! GameState::Running) return;就把暂停和结束一起挡掉了不用写if (m_over || m_paused)。状态迁移也很清楚Running收到空格进Paused收到 R 回Running同时 reset撞墙或撞自己进OverOver只接受 R。简略版为了代码短用 bool 也能接受但二次开发加“倒计时开始”“关卡切换”时建议第一时间换成枚举不然状态位会越加越乱。3. 核心模块拆解一条 120ms 的 tick 链路从方向输入到蛇身落格贪吃蛇的全部逻辑可以压缩成一句话每隔固定时间把蛇头往当前方向推一格判断是否吃到食物、是否撞死然后重绘。这个“每隔固定时间”就是QTimer的timeout信号间隔一般取 120160ms太快人反应不过来太慢手感像 PPT。下面按一次 tick 的完整链路往下拆。3.1 蛇身数据结构std::deque 与 QPoint蛇的本质是一个有序的点序列头在最前尾在最后。移动一格的操作是“头部插入一个新点尾部删掉一个点”这正是双端队列的强项#include deque #include QPoint std::dequeQPoint m_snake; // front 蛇头back 蛇尾 QPoint m_dir{1, 0}; // 当前方向单位向量 QPoint m_food; // 食物所在的格子坐标用QPoint而不是自定义struct Pos { int x, y; }是因为QPoint自带operator后面判重、判撞、std::find全都能直接用还省了一个哈希函数的活。坐标存的是“格子下标”而不是像素023 这种范围和像素的换算只发生在绘制那一刻。std::deque对比std::vectorvector头部插入是 O(n)蛇长到几十节时每帧都要整体搬一次deque头尾插入删除都是 O(1)代价是随机访问略慢一点但这个场景里除了绘制要遍历没有随机访问需求。用QListQPoint也行Qt 6 的QList已经是vector实现了头插一样是 O(n)所以还是std::deque更贴切。注意std::deque的迭代器在头尾插入删除后会失效别在遍历蛇身的同时做push_front先算完再改。3.2 tick 主循环移动、吃食物、死亡三条分支一次 tick 的完整实现大概是这样void GameWidget::tick() { if (m_over || m_paused) return; // 暂停或结束这一帧直接跳过 // 一个 tick 只消费一个方向防止连按两键互相覆盖 if (!m_input.isEmpty()) { QPoint d m_input.dequeue(); if (d ! -m_dir) m_dir d; // 二次保险禁止 180 度掉头 } const QPoint head m_snake.front() m_dir; // 算出新蛇头还没落盘 if (hitWall(head) || hitSelf(head)) { // 先判死再改数据 m_over true; m_timer.stop(); update(); return; } const bool eat (head m_food); m_snake.push_front(head); // 头插蛇变长一格 if (eat) { m_score 10; if (m_score m_best) m_best m_score; m_timer.setInterval(qMax(60, kBaseInterval - m_score / 5)); // 越吃越快 spawnFood(); } else { m_snake.pop_back(); // 尾删长度不变整体前移 } update(); // 请求重绘Qt 会合并多次调用 }顺序上有两个细节值得单独说。第一碰撞判定必须用“算出来的 head”而不是先push_front再判断——先落盘的话蛇头已经进了m_snakehitSelf会拿它跟自己比必然判定撞死。第二吃食物时不能pop_back这就是“吃到变长”的实现方式不吃时才删尾巴保持长度不变。update()在一帧里调用一次就够了Qt 内部会把多次update()合并成一次paintEvent所以不用自己维护脏标记。3.3 碰撞检测墙、自身、尾节点的特殊处理撞墙的判定很直接越界即死bool GameWidget::hitWall(const QPoint p) const { return p.x() 0 || p.x() kCols || p.y() 0 || p.y() kRows; }撞自己就要小心了这里有一个非常经典的误判bool GameWidget::hitSelf(const QPoint p) const { // 尾节点这一 tick 会移走不算障碍 // 吃食物时尾巴不动但食物只生成在空格上head 不可能同时等于尾节点所以安全 for (auto it m_snake.begin(); it ! m_snake.end() - 1; it) if (*it p) return true; return false; }为什么排除最后一个节点假设蛇长 3 节头在 (5,5)尾巴在 (4,5)蛇往左走一步新头是 (4,5)——正是尾巴当前的位置。但这一帧尾巴会移走所以实际不会撞上。如果判定时把尾巴也算进去就会出现“明明还有空隙却死了”的玄学现象玩家一眼就能看出不对。反过来也有坑如果这一帧吃到食物尾巴不动那么新头等于尾节点就真该死了。但在本实现里食物只生成在空格上spawnFood会排除蛇身所有格子所以“头等于尾”和“吃到食物”不可能同时成立排除尾巴是安全的。这个推理链条要在注释里写清楚不然下次改食物生成逻辑时这个假设就悄悄失效了。另外m_snake.end() - 1在 deque 上对随机访问迭代器是合法的蛇长度恒 ≥ 3不会出现空容器减一的情况。3.4 食物生成与棋盘占满的兜底食物生成看着简单随手rand() % kCols就完事但它有个隐性要求不能生成在蛇身上否则玩家永远吃不到游戏卡死。最稳的做法是先收集所有空格再随机取void GameWidget::spawnFood() { QVectorQPoint freeCells; freeCells.reserve(kCols * kRows - int(m_snake.size())); for (int y 0; y kRows; y) for (int x 0; x kCols; x) { QPoint p(x, y); if (std::find(m_snake.begin(), m_snake.end(), p) m_snake.end()) freeCells.append(p); } if (freeCells.isEmpty()) { // 蛇塞满整个棋盘 通关 m_over true; m_timer.stop(); return; } m_food freeCells.at(QRandomGenerator::global()-bounded(freeCells.size())); }480 个格子遍历一遍对 120ms 一次的频率来说开销可以忽略完全不需要优化成“随机重试直到不撞”的做法——那个做法在蛇很长时会退化成近似死循环蛇占了 479 格时可能抽几百次都抽不中是血泪经验。QRandomGenerator::global()是 Qt 5.10 提供的线程安全随机源替代了老的qrand()。生成范围是[0, size)正好当数组下标用。3.5 paintEvent 绘制与坐标换算绘制负责把格子坐标翻译成像素QRect GameWidget::cellRect(const QPoint p) const { return QRect(p.x() * kCell, p.y() * kCell, kCell, kCell); } void GameWidget::paintEvent(QPaintEvent *) { QPainter p(this); p.fillRect(rect(), QColor(24, 26, 32)); // 底色 // 棋盘格要和格子严格对齐所以不开启抗锯齿 p.setPen(QPen(QColor(255, 255, 255, 16), 1)); for (int x 0; x kCols; x) p.drawLine(x * kCell, 0, x * kCell, kRows * kCell); for (int y 0; y kRows; y) p.drawLine(0, y * kCell, kCols * kCell, y * kCell); // 食物 p.setPen(Qt::NoPen); p.setBrush(QColor(255, 92, 92)); p.drawEllipse(cellRect(m_food).adjusted(3, 3, -3, -3)); // 蛇身越靠头越亮一眼能看出方向 for (int i 0; i int(m_snake.size()); i) { p.setBrush(QColor::fromHsv(150, 180, qMax(90, 255 - i * 6))); p.drawRoundedRect(cellRect(m_snake[i]).adjusted(1, 1, -1, -1), 6, 6); } // 分数 p.setPen(Qt::white); p.setFont(QFont(QStringLiteral(monospace), 12)); p.drawText(rect().adjusted(8, 6, -8, 0), Qt::AlignLeft | Qt::AlignTop, QStringLiteral(SCORE %1 BEST %2).arg(m_score).arg(m_best)); // 暂停 / 结束遮罩 if (m_over || m_paused) { p.fillRect(rect(), QColor(0, 0, 0, 140)); p.setPen(Qt::white); p.setFont(QFont(QStringLiteral(monospace), 20, QFont::Bold)); p.drawText(rect(), Qt::AlignCenter, m_over ? QStringLiteral(GAME OVER - 按 R 重开) : QStringLiteral(PAUSED)); } }adjusted(1,1,-1,-1)是把矩形四边各缩 1 像素让相邻蛇身之间留出缝隙视觉上才有“一节一节”的感觉adjusted(3,3,-3,-3)让食物比格子小一圈看起来像个球而不是方块。遮罩用QColor(0,0,0,140)半透明黑盖一层比单独画一个居中面板简单得多。drawText传QRect加对齐标志时文本会在这个矩形内自动对齐但不会自动换行——所以提示语写成了一行避免出现文字被裁掉的情况。真要多行就加Qt::TextWordWrap。4. 键盘输入与游戏循环方向队列、失焦暂停和重开逻辑怎么写才不粘手这一章处理的是“手感”。同样一套规则方向变量写法不同玩起来就是两个游戏一个是顺滑的一个是按下右键却撞死在左墙上的。贪吃蛇的输入有个特殊性——玩家的操作频率可能高于 tick 频率两次按键之间蛇还没动这时候第二次按键该丢弃、该覆盖、还是该排队决定了整个手感。4.1 keyPressEvent 与自定义焦点的获取先得有焦点QWidget默认不接收键盘事件GameWidget::GameWidget(QWidget *parent) : QWidget(parent) { setFixedSize(kCols * kCell, kRows * kCell); setFocusPolicy(Qt::StrongFocus); // 必须否则收不到按键 setWindowTitle(QStringLiteral(Snake / Qt)); connect(m_timer, QTimer::timeout, this, GameWidget::tick); reset(); m_timer.start(kBaseInterval); }Qt::StrongFocus表示既接受 Tab 焦点也接受点击焦点。只写Qt::ClickFocus的话程序启动时窗口没有焦点玩家按方向键毫无反应得先用鼠标点一下窗口——这是新手最常见的“代码没错但游戏不动”的原因。Qt::StrongFocus能保证窗口一显示就拿到键盘。按键分发void GameWidget::keyPressEvent(QKeyEvent *event) { switch (event-key()) { case Qt::Key_Up: case Qt::Key_W: enqueueDir({0, -1}); break; case Qt::Key_Down: case Qt::Key_S: enqueueDir({0, 1}); break; case Qt::Key_Left: case Qt::Key_A: enqueueDir({-1, 0}); break; case Qt::Key_Right: case Qt::Key_D: enqueueDir({1, 0}); break; case Qt::Key_Space: if (!m_over) { m_paused !m_paused; update(); } break; case Qt::Key_R: reset(); break; default: QWidget::keyPressEvent(event); return; // 不认识的键交还父类 } }default分支里调用父类实现不是客套是让 Esc、AltF4 这些系统键还能正常走。全部吞掉的话窗口可能连关闭快捷键都失效。4.2 方向队列为什么一个 QPoint 变量一定会翻车最容易写错的版本长这样case Qt::Key_Up: m_dir {0, -1}; break; case Qt::Key_Left: m_dir {-1, 0}; break;看着没问题实际会出两类 bug。第一类是“吃掉一次转向”蛇正在向右走玩家飞快地按了“上”再按“左”想走一个拐角两次按键都发生在同一个 tick 之间m_dir被覆盖成左而上键那次转向直接消失。玩家体感是“我明明按了上”。第二类是“瞬间自杀”蛇向右走玩家按了“上”又立刻按“下”m_dir变成下——而“下”正是当前方向的反向下一帧蛇头直接撞进自己的脖子。正确做法是用一个容量很小的队列void GameWidget::enqueueDir(QPoint d) { if (m_over || m_paused) return; if (m_input.size() 2) return; // 最多缓存两帧防止按键堆积 const QPoint base m_input.isEmpty() ? m_dir : m_input.last(); if (d base || d -base) return; // 同向或反向直接丢弃 m_input.enqueue(d); }三个判断各有用途。size() 2的上限是为了防止玩家疯狂按键把队列塞满导致松开手之后蛇还在“执行历史指令”转圈那种延迟感非常难受。d base是同向重复没必要记。d -base是反向必须拿“队列里最后一个方向”做基准而不是m_dir——因为队列里可能已经压了一个待执行的转向用m_dir比较会漏掉“上、下”这种连续反向的情况。tick()里每次只出队一个这样连按两个不同方向时蛇会分两帧依次拐弯走出一条 L 形这就是玩家期待的行为。4.3 失焦暂停与重开别让玩家切个窗口回来就死窗口失焦的处理经常被忽略。玩家按 AltTab 切出去看个消息回来发现蛇已经撞墙了这种体验很伤void GameWidget::focusOutEvent(QFocusEvent *event) { if (!m_over) m_paused true; // 切走自动暂停 update(); QWidget::focusOutEvent(event); }注意是暂停而不是停定时器。定时器继续跑tick()开头一看m_paused直接返回逻辑更简单恢复时也不用重启定时器、不用重新对齐相位。如果为了省电想真停下那恢复时得m_timer.start(interval)并且注意别把剩余时间算错。重开走reset()它要把所有状态回滚到初始值包括那些容易被漏掉的void GameWidget::reset() { m_snake.clear(); const int cy kRows / 2; m_snake.push_back({6, cy}); m_snake.push_back({5, cy}); m_snake.push_back({4, cy}); // 头在前尾在后蛇头朝右 m_dir {1, 0}; m_input.clear(); // 队列必须清否则重开后蛇自己拐弯 m_score 0; m_over false; m_paused false; m_timer.setInterval(kBaseInterval); // 速度也要复位 spawnFood(); update(); }m_input.clear()和m_timer.setInterval(kBaseInterval)是最容易漏的两行。前者漏了玩家在死亡瞬间按的方向会在重开后立刻生效蛇开局就往奇怪的方向跑后者漏了重开后直接继承上一局的高难度速度越玩越快最后快到看不清。4.4 定时器精度与手感调优QTimer默认是Qt::CoarseTimer精度约 5%对 140ms 来说偏差 7ms 左右玩起来感觉不到。但如果你的间隔设到 60ms 以下追求“高速模式”就该显式指定m_timer.setTimerType(Qt::PreciseTimer)否则抖动会变成肉眼可见的节奏不匀。调试手感时我一般会把几个参数做成可以即时改的kBaseInterval起点 140、每次得分提速 12ms、下限 60ms。60ms 大概是普通人能反应过来的极限再快就只能靠背板了。改完记得同步reset()里的复位值不然会出现“第一局正常、第二局起飞”的诡异现象。5. 避坑与排查编译、运行、打包三段路上最容易翻车的五件事这一章是踩坑记录按出现的时间顺序排。每一条都写了现象、原因、解决遇到问题直接对号入座别从头读。5.1 编译与链接期的两个拦路虎现象一fatal error: QWidget: No such file or directory但代码里明明#include QWidget写得没错。原因.pro里只写了QT core gui。Qt 5 之后 widgets 被拆成了独立模块gui里只有QWindow、QPainter、QColor这些QWidget、QApplication、QLabel全在widgets模块头文件路径根本没加进编译命令。解决改成QT core gui widgets。CMake 对应的写法是find_package(... COMPONENTS Widgets)加上target_link_libraries(app PRIVATE Qt6::Widgets)两处缺一个都会失败但报错点不同——find_package没写会在配置阶段就退出target_link_libraries没写则是在链接阶段报一堆undefined reference to QWidget::xxx。现象二编译通过链接时报undefined reference to vtable for GameWidget或者报undefined reference to GameWidget::staticMetaObject。原因类里写了Q_OBJECT宏但没有跑 moc。moc 负责生成信号槽所需的元对象代码包括虚函数表和staticMetaObject。qmake 项目会自动处理但如果你的.h文件没被加进HEADERSqmake 就扫描不到CMake 项目则是CMAKE_AUTOMOC没开会扫不到。解决qmake 侧确认HEADERS gamewidget.hCMake 侧确认set(CMAKE_AUTOMOC ON)且头文件被列进了add_executable的源文件列表里。这个错误的迷惑性在于它看起来像“析构函数没定义”或者“虚函数没实现”很容易往错的方向查。提示如果一次改动后突然冒出 vtable 错误先尝试删掉 build 目录重新构建。moc 生成的中间文件有时会残留增量构建会拿旧的凑合清一次就正常了。5.2 运行时的两个逻辑坑现象三蛇明明还有空间却在自己撞到自己之前就判死了或者反过来蛇头穿过了尾巴玩家觉得“这都能活”。原因hitSelf的判定集合错了。一种写法是把整个m_snake都拿去比包括那个即将移走的尾节点导致紧贴尾巴走的时候误判另一种是判定时机错先push_front再判蛇头把自己算了进去新蛇一出生就死。解决判定必须在push_front之前用算出来的head去比比较时遍历begin()到end() - 1排除尾节点。如果后续加了“吃到食物尾巴不动”的变体规则比如加速道具这个假设就失效了得改成动态判断只有当这一帧不吃食物时才排除尾巴。现象四方向键按下去感觉“粘手”快速按“上”再按“左”蛇只拐了一次或者反过来蛇不受控地绕圈。原因用单个QPoint m_dir存方向后按的覆盖先按的。反过来“绕圈”是因为把队列做成了无上限玩家连按五下蛇在接下来五帧里依次执行手停了蛇还在转。解决队列容量卡死在 2enqueueDir里用“队列尾部方向”而不是当前方向做反向判定。再加一条d base过滤同向重复能挡掉大部分误按。5.3 打包发布双击没反应现象五在自己的开发机上跑得好好的拷到别人机器上双击 exe要么毫无反应要么弹窗报“缺少 Qt5Core.dll”。原因动态链接的 Qt 程序在运行时需要Qt5Core.dll、Qt5Gui.dll、Qt5Widgets.dll三个基础库加上platforms/qwindows.dll这个平台插件。开发机上 Qt 的 bin 目录在 PATH 里所以能找到换台机器就全丢了。特别注意platforms目录是必须的缺了它程序会启动失败并打印This application failed to start because no Qt platform plugin could be initialized。解决用 Qt 自带的部署工具把所有依赖一次性拷齐# Windows在 Qt 命令行环境里执行确保 windeployqt 在 PATH 中 windeployqt --release --no-translations build/snake_qt.exe # macOS macdeployqt snake_qt.app -dmg--no-translations会跳过几十种语言包一个贪吃蛇用不上能把发布目录从几十 MB 压到十几 MB。跑完之后build目录里应该多出platforms/、styles/、几个 dll整个目录一起打包才能拷给别人。6. 二次开发从单文件 Widget 拆成可测试的游戏内核简略版为了短把绘制和逻辑塞在同一个类里。真要往上加功能第一刀应该切在“逻辑不依赖界面”这条线上不然每改一条规则都得开窗口手动点半天验证效率极低。具体做法是把tick()里的纯逻辑抽成一个不继承QWidget的GameCore类m_snake、m_food、m_score、hitWall、hitSelf、spawnFood全部搬过去对外只暴露step()、turn(QPoint)、reset()和几个只读访问器。GameWidget变成一个纯粹的“渲染 输入适配层”QTimer触发时调core.step()然后update()。这之后GameCore就能脱离 Qt 的界面模块单测了喂一串方向、跑 N 步、断言蛇长和分数几毫秒跑完比手点一百次可靠。顺手的几个小改造按性价比排难度递增已经在tick()里用setInterval实现了改成独立函数更方便调参void GameWidget::applyDifficulty() { const int step m_score / 50; // 每 50 分提一档 const int interval qMax(60, kBaseInterval - step * 12); // 下限 60ms m_timer.setInterval(interval); }可掉头模式穿墙只需要改hitWall的调用点把越界坐标取模回绕// 穿墙出界后从对面进来hitWall 不再判死 head.setX((head.x() kCols) % kCols); head.setY((head.y() kRows) % kRows);最高分持久化用QSettings三行就够不用自己造配置文件格式#include QSettings // 构造函数里读 QSettings cfg(QStringLiteral(SomeStudio), QStringLiteral(snake_qt)); m_best cfg.value(QStringLiteral(best)).toInt(); // 游戏结束那一刻写 cfg.setValue(QStringLiteral(best), m_best);组织名和应用名都是占位换成自己的即可QSettings在 Windows 上会落到注册表Linux 落到~/.config跨平台不用管。验证改动的顺序我固定成三步先单元测试跑GameCore确认规则对再跑一次带界面的确认渲染没崩最后打包一份到没有 Qt 环境的机器上双击确认依赖齐全。三步里第二步最容易被跳过但恰恰是渲染层最容易出问题——逻辑对、画面错比逻辑错更难查。从那以后我每次拆这类小项目都先把“逻辑核心”和“界面外壳”的边界画出来再动手哪怕最终只有三百行也强制走一遍这个分层。边界不清的时候加第三个功能就会开始互相牵连改一处崩两处。希望帮到你。本文还有配套的精品资源点击获取
时间复杂度解法详解)
