C++实战：从零实现泡泡堂小游戏，掌握游戏循环与碰撞检测

简介这是一份面向C初学者与课程设计需求者的泡泡堂小游戏完整源码工程适合用来练习面向对象编程、图形绘制与网络通信等综合技能。项目基于C实现涵盖地图与人物绘制、水泡效果、鼠标键盘交互、障碍物碰撞、泡泡放置与爆炸以及鞋子、泡泡、药水三种增强道具并实现局域网联机对战与多人同图游戏另附房间表、多张地图和临终礼物等拓展功能。压缩包共41个文件约1.2MB以11个h头文件与10个cpp源文件构成核心逻辑配合7张png贴图、2个ttf字体及sln、vcxproj等工程配置目录按Classes、Resources、proj.win32等模块划分结构清晰便于二次开发。目前已有497人学习下载读者可借此理解游戏主循环、场景切换、道具系统与联机同步的实现思路并对照源码完成课程设计或功能扩展。1. 从零写一个泡泡堂为什么 C 小游戏是练手的最佳选择很多人第一次想用 C 写点看得见的东西脑子里冒出来的就是贪吃蛇、俄罗斯方块再往上一点就是泡泡堂。原因很实在泡泡堂的规则足够简单——放泡泡、炸开、炸到人就输——但实现起来又足够复杂涉及地图网格、实时输入、碰撞判定、定时器、状态机这一整套东西。它不像写个控制台计算器那样毫无成就感也不像写 3D 引擎那样一上来就被劝退。用 C 实现泡泡堂小游戏本质上是在练一件事怎么把一堆离散的游戏规则翻译成每帧都在跑的循环逻辑。这篇文章面向的是刚学完 C 基础语法、想找个项目把指针、数组、类、随机数这些知识点串起来的人也面向那些做过控制台小游戏、想升级到图形界面和实时交互的开发者。我会按我实际写过的路径从环境配置讲到可运行的最小版本再到手感调优和踩坑记录代码都能直接抄。2. 环境选型与最小可运行框架别在第一步就翻车2.1 图形库怎么选EasyX、SFML 还是纯 Win32C 本身不带图形界面泡泡堂要画格子、画人物、响应键盘必须挂一个图形库。常见做法有三种我按上手难度和适用场景列一下。方案上手难度适合人群主要限制EasyX低刚学完 C 语法、在 Windows 上写课程设计只支持 Windows Visual StudioAPI 偏老SFML中想跨平台、想理解游戏循环本质需要自己配 CMake 或手动链接库纯 Win32 GDI高想彻底搞懂窗口消息机制代码量大画图效率低如果你只是想在 Windows 上快速看到泡泡堂跑起来EasyX 是最短路径。它把窗口创建、绘图、键盘消息都封装成了几个函数你不需要理解 Windows 消息循环就能开始画格子。但如果你以后想把这个项目放到别的系统上或者想真正理解游戏主循环SFML 更值得投入。我下面用 SFML 讲因为它的结构更接近真实游戏开发而且换到 EasyX 只是把绘图函数替换掉的事。2.2 用 SFML 搭出窗口和主循环先确保你有一个能编译 C 的环境。Visual Studio 社区版、VS Code MinGW、CLion 都可以。SFML 的安装方式按平台不同Windows 上我一般直接下载预编译包把头文件和库文件路径配到项目里。#include SFML/Graphics.hpp #include iostream int main() { // 创建 800x600 的窗口标题为 BubbleTown sf::RenderWindow window(sf::VideoMode(800, 600), BubbleTown); window.setFramerateLimit(60); // 锁定 60 帧避免 CPU 空转 // 用一个矩形代表玩家后续替换成贴图 sf::RectangleShape player(sf::Vector2f(40.f, 40.f)); player.setFillColor(sf::Color::Blue); player.setPosition(100.f, 100.f); while (window.isOpen()) { sf::Event event; while (window.pollEvent(event)) { if (event.type sf::Event::Closed) window.close(); } // 每帧根据键盘状态移动玩家 float speed 3.f; if (sf::Keyboard::isKeyPressed(sf::Keyboard::Left)) player.move(-speed, 0.f); if (sf::Keyboard::isKeyPressed(sf::Keyboard::Right)) player.move(speed, 0.f); if (sf::Keyboard::isKeyPressed(sf::Keyboard::Up)) player.move(0.f, -speed); if (sf::Keyboard::isKeyPressed(sf::Keyboard::Down)) player.move(0.f, speed); window.clear(sf::Color::White); window.draw(player); window.display(); } return 0; }这段代码的逻辑很直白窗口开着就一直循环每轮先处理关闭事件再读键盘状态移动矩形最后清屏、画、刷新。setFramerateLimit(60)是关键不加的话循环会跑满 CPU风扇狂转。pollEvent只处理窗口级事件键盘的持续按住状态用isKeyPressed查这是实时移动的标准写法。参数上speed 3.f是每帧移动的像素数60 帧下相当于每秒 180 像素。这个值后面要跟格子大小对齐否则人物会卡在格子中间。窗口 800x600 是我习惯的尺寸刚好能放下 20x15 个 40 像素的格子泡泡堂的地图一般就是这种网格。2.3 把地图抽象成二维数组泡泡堂的地图是格子状的硬编码每个障碍物位置不现实。我一般用一个二维整型数组表示地图0 是空地1 是硬墙不可破坏2 是软墙可被炸掉。const int ROWS 15; const int COLS 20; const int TILE 40; // 每个格子 40 像素 int map[ROWS][COLS] {0}; // 初始化边界和偶数行列放硬墙其余随机放软墙 void initMap() { for (int r 0; r ROWS; r) { for (int c 0; c COLS; c) { if (r 0 || c 0 || r ROWS - 1 || c COLS - 1) map[r][c] 1; // 边界硬墙 else if (r % 2 0 c % 2 0) map[r][c] 1; // 固定硬墙保证通路 else map[r][c] (rand() % 100 30) ? 2 : 0; // 30% 概率软墙 } } }这里用rand()生成随机数但要注意不调用srand()的话每次地图都一样。我一般在main开头加srand((unsigned)time(nullptr));。另外硬墙放在偶数行列是泡泡堂的经典布局保证玩家永远有路可走不会开局就被封死。地图数组和屏幕坐标的换算关系是格子(r, c)对应屏幕位置(c * TILE, r * TILE)。这个换算会在碰撞检测和绘制里反复用到建议封装成两个函数toScreenX(c)和toScreenY(r)避免到处写乘法。3. 泡泡、爆炸与碰撞把游戏规则翻译成代码3.1 放泡泡用对象池管理动态实体泡泡不是地图的一部分它会消失数量也不固定。我一般用一个固定大小的数组当对象池每个泡泡记录格子坐标和剩余存活时间。struct Bubble { int row, col; float timer; // 剩余秒数 bool active; }; const int MAX_BUBBLES 50; Bubble bubbles[MAX_BUBBLES]; // 在玩家所在格子放一个泡泡 void placeBubble(int row, int col) { for (int i 0; i MAX_BUBBLES; i) { if (!bubbles[i].active) { bubbles[i] {row, col, 3.0f, true}; // 3 秒后爆炸 return; } } }对象池的好处是不用动态new/delete避免内存碎片也方便遍历。timer每帧减去deltaTime减到 0 就触发爆炸。这里用float存秒数而不是帧数是因为帧率可能波动按时间算更稳。放泡泡前要检查两件事当前格子没有泡泡、当前格子不是墙。漏掉任何一个就会出现泡泡叠墙或者一个格子多个泡泡的玄学 bug。3.2 爆炸判定十字火焰的递归与边界泡泡爆炸后向四个方向各延伸若干格遇到硬墙停遇到软墙炸掉软墙并停遇到泡泡可能引发连锁。我一般用递归或者队列实现。// 从 (r, c) 向方向 (dr, dc) 延伸火焰range 为射程 void spreadFire(int r, int c, int dr, int dc, int range) { if (range 0) return; int nr r dr; int nc c dc; if (nr 0 || nr ROWS || nc 0 || nc COLS) return; if (map[nr][nc] 1) return; // 硬墙挡住 if (map[nr][nc] 2) { // 软墙炸掉 map[nr][nc] 0; return; } // 标记火焰格子这里简化为直接判定玩家 checkPlayerHit(nr, nc); spreadFire(nr, nc, dr, dc, range - 1); }递归的终止条件有三个超出地图、碰到硬墙、射程用完。碰到软墙时炸掉并返回火焰不再继续。checkPlayerHit判断玩家是否在火焰格子上是的话扣血或判负。射程range默认是 1也就是泡泡本身那一格加上下左右各一格。吃道具后可以加到 2 或 3。连锁爆炸的处理是火焰碰到另一个 active 的泡泡时把那个泡泡的 timer 直接设为 0让它下一帧爆炸这样自然形成连锁不用在递归里直接调爆炸函数避免递归过深。3.3 碰撞检测格子对齐比像素级判定更靠谱泡泡堂里玩家移动是格子对齐的但移动过程是连续的。如果每帧都做像素级碰撞会出现卡在墙缝里的情况。我的做法是移动前先算出目标格子如果目标格子是墙或泡泡就不允许移动。void tryMove(int row, int col, int dr, int dc) { int nr row dr; int nc col dc; if (nr 0 || nr ROWS || nc 0 || nc COLS) return; if (map[nr][nc] ! 0) return; // 墙挡住 if (isBubbleAt(nr, nc)) return; // 泡泡挡住 row nr; col nc; }但这样移动会一格一格跳手感很硬。实际项目里我会让玩家在格子内平滑移动只在跨越格子边界时做一次碰撞检查。具体做法是记录玩家的像素坐标每帧加上速度当像素坐标接近下一个格子中心时检查那个格子能不能进不能进就把像素坐标钳住。这个细节决定了游戏是「能玩」还是「好玩」后面第 5 章会展开。4. 避坑与排查泡泡堂开发中最容易翻车的 5 个地方4.1 现象人物移动速度在不同电脑上不一样原因用固定像素数当每帧位移帧率高的机器跑得快。解决所有移动、计时都乘以deltaTime用sf::Clock记录上一帧到这一帧的秒数速度单位改成像素每秒。4.2 现象泡泡爆炸后火焰不消失或者消失得太快原因火焰的存活时间没有独立管理跟泡泡的 timer 混在一起。解决火焰单独用一个结构体数组爆炸时生成火焰并设一个 0.3 秒的短 timer每帧递减到 0 就标记 inactive。泡泡和火焰的生命周期必须分开。4.3 现象玩家能穿过软墙或者被软墙卡住动不了原因碰撞检测只查了硬墙map 1漏了软墙map 2。解决把「不可通行」统一成一个判断函数isBlocked(r, c)里面同时检查硬墙、软墙和泡泡所有移动和放泡泡的地方都调这个函数避免逻辑分散。4.4 现象连锁爆炸时程序卡死或崩溃原因递归爆炸没有终止条件两个泡泡互相触发。解决爆炸时不要直接递归调用另一个泡泡的爆炸函数而是把那个泡泡的 timer 设为 0让主循环下一帧统一处理。这样爆炸是逐帧展开的既安全又有视觉节奏。4.5 现象编译时报microsoft visual c 14.0 is required原因这是 Python 装包时的经典报错但如果你在 Windows 上用 pip 装某些构建工具也会遇到。解决装 Visual Studio Build Tools勾选「C 生成工具」。如果你只是写 C 游戏直接用 Visual Studio 社区版不要走 MinGW 和 pip 混搭的路线环境冲突是血泪经验。5. 手感调优与进阶让泡泡堂从能玩到耐玩5.1 用 deltaTime 统一时间轴前面提过所有跟时间相关的量都要乘deltaTime。我一般定义一个全局的float dt每帧开头更新。sf::Clock clock; float dt 0.f; while (window.isOpen()) { dt clock.restart().asSeconds(); // 上一帧耗时单位秒 // 移动speed 单位是像素/秒 float speed 180.f; if (sf::Keyboard::isKeyPressed(sf::Keyboard::Left)) player.move(-speed * dt, 0.f); // 泡泡计时 for (auto b : bubbles) { if (b.active) { b.timer - dt; if (b.timer 0.f) explode(b); } } }clock.restart()返回上一帧到现在的时长同时重置时钟。asSeconds()转成秒。这样在 30 帧和 144 帧的机器上移动速度和爆炸时间都一致。注意dt不要用来做单次触发的判断比如「按下空格放泡泡」应该用事件而不是isKeyPressed否则按住空格会每帧放一个。5.2 格子内平滑移动的实现技巧纯格子跳动手感差纯像素移动又容易卡墙。我的折中方案是玩家有一个像素坐标和一个目标格子移动时像素坐标向目标格子中心插值到达后再接受新的方向输入。// 玩家结构 struct Player { float px, py; // 像素坐标 int targetRow, targetCol; // 目标格子 bool moving; }; void updatePlayer(Player p, float dt) { if (!p.moving) { // 空闲时读取方向设置目标格子 int dr 0, dc 0; if (sf::Keyboard::isKeyPressed(sf::Keyboard::Up)) dr -1; else if (sf::Keyboard::isKeyPressed(sf::Keyboard::Down)) dr 1; else if (sf::Keyboard::isKeyPressed(sf::Keyboard::Left)) dc -1; else if (sf::Keyboard::isKeyPressed(sf::Keyboard::Right)) dc 1; if (dr ! 0 || dc ! 0) { int nr p.targetRow dr; int nc p.targetCol dc; if (!isBlocked(nr, nc)) { p.targetRow nr; p.targetCol nc; p.moving true; } } } else { // 向目标格子中心移动 float tx p.targetCol * TILE TILE / 2.f; float ty p.targetRow * TILE TILE / 2.f; float dx tx - p.px; float dy ty - p.py; float dist std::sqrt(dx * dx dy * dy); float step 200.f * dt; // 每秒 200 像素 if (dist step) { p.px tx; p.py ty; p.moving false; } else { p.px dx / dist * step; p.py dy / dist * step; } } }这段逻辑的关键是「移动中不接受新方向」保证一次只走一格走到格子中心才响应下一个输入。step是每帧移动距离dist是到目标中心的距离小于一步就直接吸附到中心避免在中心附近抖动。这个写法比纯格子跳动顺滑又不会出现半格卡墙。5.3 用状态机管理游戏流程泡泡堂有开局、进行中、结算三个状态。我一般用一个枚举加switch管理避免用一堆 bool 标志。状态行为Playing接受输入更新泡泡和火焰检测胜负GameOver停止更新显示结算画面等待重开Paused不更新逻辑只渲染当前画面状态切换的触发点要明确玩家被火焰命中切到 GameOver按 R 键切回 Playing 并重置地图。状态机的好处是逻辑不会互相干扰比如 GameOver 时按方向键不会让尸体继续走。5.4 一个我踩过的坑随机数种子只种一次rand()的种子srand()在整个程序里只需要调一次放在main开头。我曾经在initMap()里每次重开都调srand(time(nullptr))结果一秒内重开多次种子一样地图完全没变。后来改成只在main里种一次重开时直接rand()地图才有变化。这个坑很隐蔽因为单次运行看不出来只有快速重开才会暴露。写泡泡堂这类小游戏最深的体会是规则简单不等于实现简单真正花时间的是边界情况和手感。我现在的习惯是先把最小可运行版本跑通再逐条加规则每加一条就手动测一遍异常路径。希望帮到你。本文还有配套的精品资源点击获取