简介：这套泡泡堂（炸弹人）小游戏的C/C++完整源码，适合游戏开发初学者和进阶者用于学习2D游戏程序设计，也适合作为高校课程设计或兴趣项目的参考资料。项目基于C++与EGE图形库实现，完整覆盖游戏主循环、界面渲染、键盘输入响应、碰撞检测与爆炸效果等核心逻辑。压缩包共含346个文件、大小约75MB，其中图片资源占比最高，包括235个PNG与50个JPG场景和角色素材，另有13个WAV背景音乐、C++源文件、可执行程序及Code::Blocks工程文件，目录结构清楚，便于直接打开运行和对照阅读。目前已有3600人学习下载。通过研读这份源码，可理解炸弹放置、爆炸范围判定、角色移动等机制的代码实现，学习如何将面向对象设计与图形媒体资源整合成完整小游戏，并可根据自身需求修改素材和逻辑，是一份能切实提升C++项目实践能力的参考材料。
1. 一个能跑起来的 C++ 游戏源码，比空讲语法有用得多
很多人在学完 C++ 的类、指针、容器之后，都会卡在同一个问题上：学了一堆语法，但真正让自己写一个能双击运行、能看到画面、能听到声音的程序，却完全无从下手。这份泡泡堂（炸弹人）小游戏源码，就是从“语法学到了”到“能写出一个完整游戏”之间的那座桥。它用 C/C++ 在 Windows 下实现了一个完整的炸弹人对战玩法，包含地图渲染、角色移动、炸弹爆炸、道具效果、敌方 AI，以及背景音乐和图片资源，整个工程拿来就能编译、能玩、能改。适合刚学完 C++ 想做课程设计或练手项目的人，也适合想看看别人怎么写游戏主循环、怎么做碰撞检测的开发者——它不是教学 Demo，而是一个可以直接跑起来参考的完整工程。
2. 项目结构拆解：地图、实体、资源三层各管各的
先别急着打开代码。拿到任何一个源码工程，我习惯先看一遍它分了多少个文件、每个文件大致在管什么，再决定先读哪个模块。
2.1 技术选型：Windows + EasyX，用 C++ 写带画面的程序
这个源码的运行平台是 Windows，图形部分用的是 EasyX 图形库。EasyX 是很多 C/C++ 入门游戏项目的常见选择，它把 Windows GDI 封装成了类似 Turbo C 的绘图接口，initgraph开窗口、loadimage加载图片、getch接收键盘输入，几百行代码就能跑出画面。
背景音乐和图片这两样资源也印证了这个方向：加载图片直接调用loadimage，播放音乐用 Windows 的多媒体接口mciSendString。这套技术在 Windows 控制台游戏里用得非常多，比引入整个游戏引擎轻得多，也更容易看懂。
2.2 文件结构：每个文件负责一类事
这类项目通常不会把代码堆在一个 main.cpp 里，而是按职责拆开。比较典型的目录结构是这样：
Bomber/ │ main.cpp // 入口，游戏主循环 │ game.h // 游戏状态枚举、全局常量 │ game.cpp // 游戏流程控制：初始化、更新、渲染 │ map.h / map.cpp // 地图数据与地图绘制 │ player.h / player.cpp // 玩家角色：移动、放炸弹、死亡判定 │ enemy.h / enemy.cpp // 敌人 AI：巡逻、躲避爆炸 │ bomb.h / bomb.cpp // 炸弹逻辑：倒计时、爆炸、地形破坏 │ prop.h / prop.cpp // 道具：加速、加炸弹数量、爆炸范围 │ resources/ // 图片与音乐资源目录 │ bgm.mp3 │ role_left.bmp / role_right.bmp ...大概浏览一遍就能看出：map管格子，player和enemy管角色，bomb管爆炸，prop管道具，resources管图片和音频。这个拆分不算复杂，但每类东西都有独立的文件，二次开发时想改哪块就进哪个文件，比全部代码堆在 main 里好改得多。
2.3 模块怎么串起来：游戏主循环是唯一总线
各模块之间不是互相直接调用，而是由 main.cpp 里的游戏主循环统一驱动。简化后的主循环大概是这样的逻辑：
while (running) { handleInput(); // 读取键盘，更新玩家移动方向 updateAll(); // 更新炸弹倒计时、角色位置、AI 行为 checkCollision(); // 角色与炸弹、爆炸、道具的碰撞检测 renderAll(); // 绘制地图、角色、炸弹、特效 }handleInput、updateAll、renderAll这三步就是这个游戏的全部骨架。输入改变状态，状态在更新阶段推进，渲染阶段把状态画到屏幕上。这个循环结构几乎是所有 2D 小游戏的通用模板，你在这个源码里读懂它，以后看任何同类项目都会觉得眼熟。
3. 核心模块实现：地图、炸弹爆炸、碰撞检测逐个拆
这一章是重点。选三个最值得读的模块拆开讲：地图怎么用二维数组表达、炸弹爆炸怎么向四个方向扩散、角色移动和碰撞检测是怎么判断的。
3.1 地图模块：一个二维数组画出一整个场景
泡泡堂的地图本质是一张二维网格。这块的关键设计是：地图数据用数字数组表示，渲染时把数字翻译成图片，逻辑判断时直接读写数组里的值。
#define ROWS 13 #define COLS 15 // 地图图例：0=空地 1=砖块 2=硬块 3=道具 static int gameMap[ROWS][COLS] = { {2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2}, {2, 0, 0, 1, 1, 0, 1, 0, 1, 0, 1, 1, 0, 0, 2}, // ... 中间行省略 {2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2}, }; void drawMap() { for (int row = 0; row < ROWS; row++) { for (int col = 0; col < COLS; col++) { int x = col * TILE_SIZE; int y = row * TILE_SIZE; switch (gameMap[row][col]) { case 1: putimage(x, y, &imgBrick); break; case 2: putimage(x, y, &imgBlock); break; case 3: putimage(x, y, &imgProp); break; default: break; // 空地不画，显示底色 } } } }gameMap中每个数字代表一种地块类型。绘制时用一个双重循环，把数组下标换算成屏幕坐标：第row行第col列，对应的屏幕坐标就是(col * TILE_SIZE, row * TILE_SIZE)。TILE_SIZE是单格图片的像素边长，一般取 32 或 48。
逻辑上判断一个角色能不能站到某格，也是直接查gameMap[targetRow][targetCol]的值：为 0 或 3 就能走，为 1 或 2 就不能走。把地图数据和画面渲染分开，后续改地图、加新地块类型都会非常方便。
3.2 炸弹模块：爆炸沿着四个方向扩散
炸弹人玩法的核心是炸弹爆炸。爆炸的特性是：以炸弹所在格为中心，向上、下、左、右四个方向传播，碰到硬块就停下，碰到砖块就把砖块炸掉并可能生成道具。实现上用一个方向增量数组，把四个方向的扩散循环跑一遍。
typedef struct { int x, y; // 所在格子的行列坐标 int timer; // 倒计时帧数 int range; // 爆炸范围，默认 2 格 } Bomb; const int DIRS[4][2] = {{-1,0}, {1,0}, {0,-1}, {0,1}}; // 上下左右 void explodeBomb(Bomb* bomb) { // 先炸自己所在格 gameMap[bomb->y][bomb->x] = 0; for (int i = 0; i < 4; i++) { for (int step = 1; step <= bomb->range; step++) { int ny = bomb->y + DIRS[i][0] * step; int nx = bomb->x + DIRS[i][1] * step; if (gameMap[ny][nx] == 2) break; // 硬块挡住 if (gameMap[ny][nx] == 1) { gameMap[ny][nx] = 0; // 炸掉砖块 maybeSpawnProp(ny, nx); // 概率生成道具 break; // 砖块也挡住爆炸 } // 空地和道具格继续传播 gameMap[ny][nx] = 0; } } }DIRS这个二维数组是这段代码最值得记的地方。四个方向由行偏移和列偏移两个数字构成：{-1,0}是向上走一行，{1,0}是向下走一行，{0,-1}是向左走一列，{0,1}是向右走一列。配合步长step就能从炸弹位置逐步向外扫描。
内层循环在两种情况下会break：遇到硬块立刻停下，遇到砖块则炸掉砖块再停下。这保证了爆炸不会穿透障碍物一路冲出地图边界。maybeSpawnProp是另一段独立逻辑，通常会按固定概率在当前格子生成一个随机道具，把gameMap的值改成 3。
3.3 角色移动与碰撞检测：先算坐标再查格子
角色在地图上是连续移动还是按格子跳动，决定了碰撞检测怎么写。这个项目的常见做法是：角色用像素坐标连续移动，检测时把像素坐标换算成所在格子，再查格子是不是障碍物。
void movePlayer(Player* player, int dx, int dy) { int newX = player->x + dx * player->speed; int newY = player->y + dy * player->speed; // 换算成目标格子 int targetRow = newY / TILE_SIZE; int targetCol = newX / TILE_SIZE; // 检查目标位置是否可通行 if (gameMap[targetRow][targetCol] != 0 && gameMap[targetRow][targetCol] != 3) { return; // 障碍物，不能走 } // 还要检查是否撞到其他角色 if (isCollideWithOthers(player, newX, newY)) { return; } player->x = newX; player->y = newY; }这里有一个细节容易踩坑：直接检查目标点有可能让角色“卡进”障碍物里，尤其是角色图片尺寸大于单格尺寸时。更稳的做法是检查角色的四个角，或者直接计算角色矩形和障碍物矩形的相交面积。isCollideWithOthers的思路也是矩形碰撞检测，两个角色之间用位置和宽高构造矩形，调用一个rectsOverlap函数判断相交。
判断“能不能走”和判断“是否撞上”是两套逻辑：前者查地图数组，后者查其他角色的坐标范围。两套逻辑分开写，代码会清晰很多，调试时也容易定位问题。
4. 资源与画面：图片怎么加载、音乐怎么播、闪屏怎么解决
当代码逻辑已经能跑的时候，资源加载就成了决定游戏观感的关键。这个源码既然带了背景音乐和图片，资源管理部分也值得单独看看。
4.1 窗口初始化和双缓冲
EasyX 创建窗口用initgraph，但直接在每个绘制步骤里putimage会导致画面闪烁，因为绘制是一次次直接写到屏幕上的。主流做法是开双缓冲：
#include <graphics.h> #include <conio.h> IMAGE background; // 要用的图片 int main() { initgraph(COLS * TILE_SIZE, ROWS * TILE_SIZE); loadimage(&background, _T("resources/bg.bmp")); BeginBatchDraw(); // 开始批量绘制，画面先写到内存 while (running) { // ... 更新逻辑 drawMap(); drawPlayer(); // 所有绘制完成后统一刷新 FlushBatchDraw(); Sleep(16); // 大约 60 帧 } EndBatchDraw(); getch(); closegraph(); return 0; }BeginBatchDraw和FlushBatchDraw是 EasyX 提供的双缓冲接口。切断直接刷屏，把一帧里所有画面先在缓冲区画完，再一次性提交到屏幕。Sleep(16)用来控制帧率，大约 60 帧每秒。16 这个数字不是玄学，60 帧每帧间隔约 16.7 毫秒，为了稳定可以配合定时器或timeBeginPeriod提高时间精度。
4.2 图片加载的细节
图片加载最容易被环境搞挂的是路径问题。用相对路径时，程序的工作目录不一定在项目根目录。loadimage加载失败时不会立刻报错，而是等到绘制时才黑屏或花屏。
常见的做法是把 resources 目录放到工程目录下，并在代码里用相对路径或通过GetCurrentDirectory拼出绝对路径。这个源码里如果图片在 resources 子目录，写法一般是这样：
IMAGES imgRole; loadimage(&imgRole, _T("resources/role_down.bmp"), TILE_SIZE, TILE_SIZE);loadimage的第三、四个参数可以指定缩放后的宽度和高度，如果你发现图片素材尺寸比格子大，可以直接在加载时缩到需要的大小，省得在绘制阶段每次手动换算。
4.3 背景音乐播放：mciSendString 一行命令
背景音乐在 Windows 下常用mciSendString来播放。它通过命令字符串控制媒体设备，循环播放一个 bgm 是这样写的：
#include <windows.h> #pragma comment(lib, "winmm.lib") int main() { // 打开并循环播放资源目录下的音频 mciSendString(_T("open resources/bgm.mp3 alias bgm"), NULL, 0, NULL); mciSendString(_T("play bgm repeat"), NULL, 0, NULL); // 注意：部分环境对 mp3 支持不好，可转成 wav 再播放 return 0; }alias bgm给音频起了一个别名，后续play bgm repeat、close bgm都通过这个别名来操作对应文件。这里的repeat表示循环播放，如果是音效（比如爆炸声），就不要加repeat，让它播完即停。
新版 Windows 的 mci 接口对 mp3 格式有时会拒绝播放，这是编码问题而不是代码问题。遇到这种情况，把音频用格式工厂转成 44100Hz 16bit 的 wav 文件，基本能解决。
5. 跑起来的必经之路：配置、编译与常见问题排查
前面的代码再漂亮，编译不过就是零。这一章把环境配置和最常见的几个坑拉出来过一遍，都是我实际编译这类项目时踩过的。
5.1 环境配置与编译步骤
开发环境是 Windows + Visual Studio。我用的是 VS2022，用 VS2019 的写法也基本一样。
步骤一，新建一个空 C++ 项目，把源码里的.cpp和.h都拖进工程里。步骤二，安装 EasyX 库，到官网下载对应 VS 版本的安装包，运行后它会自动把graphics.h和lib文件装到 VS 的包含目录里。步骤三，给项目配置字符集。在项目属性里找到“配置属性”->“常规”->“字符集”，选“使用多字节字符集”。很多源码用了_T()宏但工程默认是 Unicode，会直接编不过。
最后一个关键配置是链接器：如果你看到报错说mciSendString找不到，就在项目属性 -> 链接器 -> 输入 -> 附加依赖项里手动加上winmm.lib。代码里的#pragma comment不一定总生效，手动加最稳。
5.2 遇到的坑和排查记录
下面这五条，是按实际踩坑概率从高到低排的。
坑一：编译报错“无法打开包括文件 graphics.h”
现象：代码第一行就红了。
原因：EasyX 没安装，或者安装时没有匹配当前 VS 版本。EasyX 的安装包是区分 VS 版本的，装错了 VS 识别不到。
解决：去官网重新下载对应 VS 年份的安装包再装一次。装完后在 VS 里新建一个空项目，随便写一句#include <graphics.h>，能编译通过就说明环境正常。
坑二：运行后窗口一片黑，地图和角色都没画出来
现象：程序能启动，窗口也是白的或黑的，但没有任何内容。
原因：最常见的是图片加载失败。loadimage返回失败时只是图片为空，绘制时也就什么都画不出来。本质是工作目录和图片目录不一致，VS 里默认的工作目录是项目目录，但双击 exe 运行时工作目录是 exe 所在的目录。
解决：把resources文件夹复制一份到 exe 旁边，或者在代码里改成绝对路径测试。最稳妥的是在 main 开头加一句设置工作目录，用_chdir切到项目根目录，这样始终都能找到图片。
坑三：中文字符串全部变成乱码
现象：控制台或者窗口标题里的中文显示成“銆愬搴”之类的内容。
原因：源码文件是 UTF-8 编码，但项目的字符集是多字节，编译器按 GBK 去解释中文字符串，于是乱码。
解决：把源文件另存为 GBK 编码，或者在每个字符串用_T()包裹并保持项目字符集为多字节。如果项目里大量中文，最省事的是用 VS 的“文件->高级保存选项”把编码转为简体中文（GB2312）。
坑四：游戏画面非常闪，或者移动不流畅
现象：角色移动时画面忽明忽暗，像老式 CRT 显示器刷新。
原因：没有用双缓冲，或者Sleep的时间太长。直接往窗口上绘制一帧就会被清屏一次，导致闪烁。
解决：检查是不是写在了BeginBatchDraw和EndBatchDraw之间。另外把Sleep(16)改成Sleep(10)或者用timeBeginPeriod(1)提高系统计时器精度，能明显改善卡顿。
坑五：背景音乐播不出来
现象：游戏一切正常，就是没有声音。
原因：两个方向排查。一是链接问题，winmm.lib没加进附加依赖项；二是文件格式问题，Windows 自带的 mci 接口对 mp3 编码支持不稳定。
解决：先检查链接器里的winmm.lib；再检查路径，把音频文件放到工作目录；最后把 mp3 转成 wav 试试。大部分场景下 wav 格式能一次成功。
6. 二次开发怎么改：加道具、改 AI、换图形库的思路
拿到手的源码跑通之后，真正的乐趣才开始。这里给三个我自己常用的改造方向，按难度从低到高排。
6.1 加一个新道具
泡泡堂的道具通常有加速鞋、炸弹数量增加、爆炸范围扩大。如果我要加一个“免疫一次爆炸”的护盾道具，改动点只有三处：在gameMap的图例里加一个数字 4；在渲染的switch里增加case 4的图片；在角色吃到道具的检测逻辑里加一个分支。核心代码只改一个函数：
void pickupProp(Player* player, int row, int col) { switch (gameMap[row][col]) { case 3: // 原有道具逻辑 player->bombCount++; break; case 4: player->shield = 1; // 新增护盾字段 break; } gameMap[row][col] = 0; // 道具被捡走 }这种“地图是一个数组、道具是数组里的值”的设计，加新东西的成本非常低。唯一要注意的是渲染里别忘了加上新图，否则会出现道具被捡走但格子还在黑屏的状态。
6.2 给 AI 敌人加决策状态
敌人 AI 通常只有两个状态：没有发现玩家就随机巡逻，发现玩家就追上去。改造方向是加一个“躲避炸弹”的状态。给每个敌人加一个行为枚举，更新逻辑里先判断炸弹距离再决定行为：
if (findBombNearby(enemy)) { enemy->aiState = RUN_AWAY; } else if (canSeePlayer(enemy)) { enemy->aiState = CHASE; } else { enemy->aiState = PATROL; }RUN_AWAY状态下，AI 选择一个远离炸弹坐标的方向移动。这个改造不用动地图模块，只改enemy.cpp内部逻辑，半天能完成。
6.3 把 EasyX 换到 SDL 实现跨平台
如果想把这个项目从 Windows 搬到 Mac 或 Linux，常规路线是换用 SDL2。对应关系大概是：initgraph换成SDL_CreateWindow+SDL_CreateRenderer，putimage换成SDL_RenderCopy，getch换成SDL_PollEvent，mciSendString换成Mix_OpenAudio+Mix_PlayMusic。地图数组、炸弹四方向扩散、碰撞检测这些核心逻辑全部可以原样保留，只替换渲染和输入部分。
迁移的工程量集中在资源加载和事件处理两处，但做完之后项目就能跨平台编译。每次做这种替换，我都会重新体会到“逻辑与渲染分离”的好处——凡是主循环和地图逻辑写得干净的源码，迁移成本都非常低。
那次我改完 AI 之后，为了验证行为是否正常，下载源码的第一步就强制自己先编译、再跑地图调试模式、最后才开始读代码，从那以后每次拿到新项目我都是这个顺序，少走了不少弯路。希望这份泡泡堂源码也能让你体会到把 C++ 语法变成可玩游戏的踏实感，祝改造顺利。
本文还有配套的精品资源，点击获取
