1. 项目概述为什么是俄罗斯方块如果你正在学习C尤其是刚刚掌握了基础语法正愁找不到一个能串联起所有知识点的实战项目那么“俄罗斯方块”几乎是一个完美的选择。它不像贪吃蛇那样过于简单也不像3D游戏那样需要复杂的图形学和数学知识。它恰到好处地涵盖了C核心的面向对象思想、数据结构、算法逻辑甚至是简单的图形界面编程。更重要的是它的规则清晰逻辑闭环实现一个可玩的版本本身就是一次对编程能力的全面检验。我见过很多新手学完了指针、类、继承但面对一个空白的项目却无从下手。俄罗斯方块这个项目就像一份经典的“试卷”它能清晰地告诉你哪些知识点你真正掌握了哪些还只是停留在书本上。通过亲手解析一份高质量的源码并实现它你不仅能获得一个可以运行、可以炫耀的作品更重要的是你能建立起从需求分析到代码实现的完整思维链条。今天我们就来彻底拆解这个经典项目我会带你从零开始理解其核心架构并一步步实现一个控制台版本的俄罗斯方块过程中遇到的每一个“坑”和技巧我都会毫无保留地分享给你。2. 核心架构与设计思路拆解在动手写代码之前我们必须先想清楚整个游戏的“骨架”。一个俄罗斯方块游戏无论界面多么花哨其核心逻辑都可以抽象为几个相互协作的模块。好的架构能让代码清晰、易维护也便于我们分步实现和调试。2.1 游戏世界的模型地图与方块游戏的核心是一个二维的网格“地图”通常宽10格高20格经典规格。我们可以用一个二维数组比如int map[20][10]来表示。数组中的每个元素代表一个“格子”0表示空非0比如1-7表示已被不同形状的方块占据。方块本身是另一个核心。俄罗斯方块有7种基本形状I, J, L, O, S, T, Z。每种形状由4个小方块我们称之为“方块单元”组成。我们需要一种方式来描述这些形状及其旋转状态。最经典的方法是使用“预定义形状表”。我们可以为每种形状定义4个旋转状态0° 90° 180° 270°每个状态用一个4x4的布尔矩阵或坐标数组来表示。例如T型方块在0度旋转时的坐标相对其中心或某个参考点可能是(0, -1), (-1, 0), (0, 0), (1, 0)。通过改变这些相对坐标就能实现旋转。将方块当前的中心坐标加上这些相对坐标就能得到方块四个单元在地图中的实际位置从而进行碰撞检测和绘制。2.2 核心循环与状态管理游戏运行在一个主循环中这个循环每秒会运行很多次例如60帧。每次循环我们大致做以下几件事处理输入检测玩家按键左、右、下、旋转、瞬间落下。更新游戏状态如果到了该自动下落的时间就让当前方块向下移动一格。根据输入尝试移动或旋转当前方块。在任何移动/旋转/下落操作后进行碰撞检测。如果发生碰撞触底或碰到其他方块则将当前方块“固化”到地图中并检查是否有可以被消除的满行。消除满行并让上面的行下落。生成一个新的随机方块作为当前方块。如果新方块一出现就发生碰撞则游戏结束。渲染输出根据最新的地图和当前方块状态在屏幕上绘制出图形。这个循环是游戏的心脏。我们需要一个变量来代表“当前正在下落的方块”包括它的类型、旋转状态和中心坐标。另一个变量代表“下一个将要出现的方块”用于预览。2.3 面向对象的设计用C实现自然要发挥其面向对象的优势。我们可以设计几个核心类Game类游戏的主控制器包含主循环管理游戏状态是否运行、分数、等级并协调其他对象。Board或Map类封装游戏地图二维数组提供方法用于检查某个位置是否被占用、将方块固化到地图、检查并消除满行等。Tetromino类代表一个俄罗斯方块。属性包括类型、旋转状态、中心坐标。方法包括移动、旋转、绘制自己、检查与地图的碰撞等。Renderer类负责渲染。在控制台版本中就是清屏并在正确位置输出字符如[]代表方块##代表墙壁空格代表空。这为将来升级到图形界面留出了接口。注意在简单的控制台版本中Game和Renderer的逻辑可能会耦合得比较紧。但先有清晰的分层意识对写出好代码至关重要。我们可以先从简单的开始再逐步重构。3. 核心细节解析与实操要点理解了架构我们来深入几个最关键的细节这些地方是新手最容易出错或感到困惑的。3.1 方块的表示与旋转算法如何优雅地表示7种形状及其4种旋转我推荐使用“局部坐标系状态表”的方式。首先我们定义一个Shape枚举类型包含7种形状。然后我们用一个三维数组来存储所有形状的所有旋转状态。这个数组可以这样声明// shapes[shapeType][rotation][blockIndex][xOrY] const int shapes[7][4][4][2] { // I型 { {{0, -1}, {0, 0}, {0, 1}, {0, 2}}, // 0度竖条 {{-1, 0}, {0, 0}, {1, 0}, {2, 0}}, // 90度横条 // ... 180度和270度 }, // J型 // ... };数组的四个维度分别是形状索引、旋转状态索引、方块单元索引0-3、坐标0是x偏移1是y偏移。这里的坐标是相对于方块“中心点”或某个“旋转原点”的偏移量。旋转的实现当玩家按下旋转键时我们获取当前方块的下一个旋转状态的偏移量数组计算新的位置并进行碰撞检测。如果旋转后发生碰撞许多现代游戏会尝试进行“踢墙”操作——即轻微调整方块的位置向左/右/上移动一格后再尝试旋转如果仍碰撞则旋转失败。我们在初版可以先不做踢墙以简化逻辑。实操心得定义这个形状表时务必在纸上画好每个形状每个旋转状态的网格图标清中心点和每个单元的偏移。这是整个游戏的数据基石一旦出错方块会显示和旋转得非常诡异。建议编写一个简单的测试函数打印出每个形状每个状态的坐标来验证。3.2 碰撞检测的逻辑碰撞检测是游戏逻辑正确性的保障。在以下操作前必须进行方块尝试向左/右/下移动。方块尝试旋转。方块自动下落。检测函数bool checkCollision(const Tetromino t, const Board b)的大致逻辑是遍历当前方块t的四个单元计算它们在地图b上的实际坐标(gridX, gridY)。判断条件gridX是否超出地图左边界0或右边界宽度gridY是否超出地图下边界高度(上边界一般不会碰到除非游戏结束)如果坐标在地图范围内该位置在地图数组中的值是否为非0已被固化方块占据以上任何条件为真即发生碰撞。关于“触底”当下落碰撞检测发生时如果是因为gridY 高度超出下边界导致的碰撞就是触底。触底后方块需要被固化。3.3 消行与地图更新当方块固化后我们需要检查地图的每一行是否被填满。一个高效的检查方法是遍历每一行判断该行所有格子是否都为非0。消行后上面的行需要下落。一个经典的错误是自上而下地处理如果你从第0行开始消除第2行后把第1行复制到第2行但第1行本身可能也需要下落逻辑就乱了。正确的做法是自下而上处理从地图最底部一行开始向上遍历。如果当前行是满行则消除比如将该行所有元素设为0。设置一个“写入指针”初始指向最底部。再次自下而上遍历但这次只将“非空行”即不全为0的行复制到“写入指针”指向的行然后写入指针上移一行。遍历结束后写入指针以上的所有行都应该被清零因为它们是空出来的区域。这个过程模拟了“消除一行上面所有行整体下落一格”的物理效果。void Board::clearLines(int linesCleared) { linesCleared 0; int writeRow HEIGHT - 1; // 从最底部开始写入 for (int row HEIGHT - 1; row 0; --row) { if (isRowFull(row)) { // 当前是满行跳过不写入相当于消除 linesCleared; } else { // 当前不是满行将其复制到writeRow位置 if (writeRow ! row) { for (int col 0; col WIDTH; col) { grid[writeRow][col] grid[row][col]; } } writeRow--; } } // 清除顶部空出来的行writeRow以上的行 for (int row writeRow; row 0; --row) { for (int col 0; col WIDTH; col) { grid[row][col] 0; } } }4. 控制台版本的实战实现步骤我们现在用Windows下的控制台来实现一个基础版本。我们将使用windows.h中的一些函数来控制光标位置和颜色让游戏看起来更美观。4.1 环境准备与项目结构首先确保你有一个C开发环境比如Visual Studio、Code::Blocks或VSCode配合MinGW。创建一个新的控制台应用项目。建议的项目文件结构TetrisConsole/ ├── main.cpp // 程序入口游戏主循环 ├── Game.h/cpp // Game类定义 ├── Board.h/cpp // Board类定义 ├── Tetromino.h/cpp // Tetromino类定义 ├── Renderer.h/cpp // 渲染器类定义 └── common.h // 公共常量、枚举定义在common.h中我们先定义一些全局常量// common.h #pragma once const int BOARD_WIDTH 10; const int BOARD_HEIGHT 20; const int BOARD_OFFSET_X 5; // 地图在控制台中的起始X坐标 const int BOARD_OFFSET_Y 2; // 地图在控制台中的起始Y坐标 enum class ShapeType { I, J, L, O, S, T, Z }; enum class GameState { PLAYING, PAUSED, GAME_OVER };4.2 核心类实现详解1. Board类Board类负责维护游戏地图状态。// Board.h #pragma once #include common.h #include vector class Board { private: std::vectorstd::vectorint grid; // 使用vector便于动态尺寸这里固定为HEIGHT*WIDTH int width, height; public: Board(int w, int h); void init(); // 初始化空地图 bool isCellEmpty(int x, int y) const; bool isRowFull(int row) const; int clearLines(); // 返回消除的行数 void solidifyPiece(int shapeId, const std::vectorstd::pairint, int cells); const std::vectorstd::vectorint getGrid() const { return grid; } // ... 其他辅助方法 };在Board.cpp中实现clearLines方法逻辑如前所述。2. Tetromino类Tetromino类代表一个活动的方块。// Tetromino.h #pragma once #include common.h #include utility #include vector class Tetromino { private: ShapeType type; int rotation; // 0-3 int posX, posY; // 中心点在地图上的坐标 static const int shapes[7][4][4][2]; // 形状表声明 public: Tetromino(ShapeType t); void reset(ShapeType t, int startX, int startY); std::vectorstd::pairint, int getCurrentCells() const; // 获取当前四个单元的绝对坐标 void move(int dx, int dy); void rotate(); void setRotation(int r) { rotation r; } // ... getters };getCurrentCells方法是关键它根据type,rotation,posX,posY和预定义的shapes表计算出四个方块单元在地图上的实际坐标。3. Renderer类控制台专用控制台渲染的核心是定位光标和设置颜色。我们将使用Windows API。// Renderer.h #pragma once #include common.h #include Board.h #include Tetromino.h #include windows.h class ConsoleRenderer { private: HANDLE hConsole; COORD getConsoleCoord(int boardX, int boardY); // 将地图坐标转换为控制台坐标 public: ConsoleRenderer(); void clearScreen(); void drawBoard(const Board board); void drawPiece(const Tetromino piece); void drawBorders(); void drawInfo(int score, int level, Tetromino nextPiece); void gotoXY(int x, int y); };在构造函数中我们可以获取控制台句柄hConsole GetStdHandle(STD_OUTPUT_HANDLE);。drawBoard函数会遍历地图数组在非空位置绘制彩色方块使用SetConsoleTextAttribute设置颜色。4. Game类Game类是整个游戏的驱动器。// Game.h #pragma once #include common.h #include Board.h #include Tetromino.h #include Renderer.h #include chrono class Game { private: Board board; Tetromino currentPiece; Tetromino nextPiece; ConsoleRenderer renderer; GameState state; int score; int level; int linesCleared; std::chrono::steady_clock::time_point lastFallTime; int getFallInterval() const; // 根据等级计算下落间隔(毫秒) void processInput(); void update(); void render(); void spawnNewPiece(); bool pieceFits(const Tetromino piece) const; public: Game(); void run(); // 主游戏循环 };4.3 主循环与时间控制游戏主循环Game::run()是核心。我们不能让循环无限制地空转那样会占满CPU。我们需要一个基于时间的更新机制。void Game::run() { using namespace std::chrono; lastFallTime steady_clock::now(); auto lastRenderTime lastFallTime; while (state ! GameState::GAME_OVER) { auto currentTime steady_clock::now(); // 1. 处理输入非阻塞 processInput(); // 2. 更新游戏状态 auto deltaTime duration_castmilliseconds(currentTime - lastFallTime).count(); if (deltaTime getFallInterval()) { update(); // 这个update里处理自动下落 lastFallTime currentTime; } // 3. 渲染控制渲染帧率比如每秒60帧 auto renderDelta duration_castmilliseconds(currentTime - lastRenderTime).count(); if (renderDelta 16) { // 约60 FPS render(); lastRenderTime currentTime; } // 短暂休眠避免CPU占用率100% Sleep(1); } // 游戏结束后的处理 renderer.gotoXY(0, BOARD_HEIGHT 5); std::cout 游戏结束最终得分: score std::endl; }processInput函数需要使用非阻塞的方式检测键盘输入。在Windows控制台可以用_kbhit()和_getch()来实现。void Game::processInput() { if (_kbhit()) { int ch _getch(); // 有些键如方向键是双字节第一个字节是0或224 if (ch 0xE0 || ch 0) { ch _getch(); // 获取第二个字节 switch (ch) { case 75: // 左箭头 tryMove(-1, 0); break; case 77: // 右箭头 tryMove(1, 0); break; case 80: // 下箭头 tryMove(0, 1); break; case 72: // 上箭头旋转 tryRotate(); break; } } else { switch (ch) { case : // 空格键瞬间落下 hardDrop(); break; case p: case P: // 暂停 togglePause(); break; case q: case Q: // 退出 state GameState::GAME_OVER; break; } } } }4.4 积分与等级系统一个完整的游戏需要有反馈。经典的积分规则是消除1行100分 * 当前等级消除2行300分 * 当前等级消除3行500分 * 当前等级消除4行Tetris800分 * 当前等级等级随着消除的总行数增加而提升例如每消除10行升一级。等级提高后方块自动下落的速度会加快getFallInterval()返回值变小。在Game::update()中当方块固化并消除行后调用计分函数更新score和level。5. 常见问题与排查技巧实录即使思路清晰实际编码中也会遇到各种“坑”。下面是我在实现过程中遇到的一些典型问题及解决方法。5.1 方块旋转时“卡墙”或位置偏移问题描述实现旋转后方块有时会嵌到墙里或其他方块里或者旋转中心飘忽不定。排查与解决检查形状表坐标这是最常见的原因。确保你的4x4局部坐标定义正确。一个技巧是在纸上画一个4x4网格中心点设为(0,0)。把你定义的四个偏移坐标标上去看是否构成你想要的形状。为每种形状的每种旋转都做这个检查。验证坐标转换在Tetromino::getCurrentCells()函数中打印出计算出的绝对坐标。手动计算几个案例看是否与预期相符。确保你在计算绝对坐标时是中心X 偏移X,中心Y 偏移Y。理解旋转中心俄罗斯方块的旋转并非总是绕几何中心。对于某些形状如I型官方游戏有特殊的旋转规则。如果你要实现完全经典的体验可能需要查阅更详细的“旋转系统”资料如SRSSuper Rotation System。对于第一个版本可以先用简单的绕中心旋转体验基本正确即可。5.2 控制台闪烁严重问题描述游戏画面更新时整个屏幕频繁闪烁体验很差。排查与解决 控制台闪烁是因为我们频繁地清屏system(“cls”)和重绘整个画面。双缓冲技术在控制台中实现真正的双缓冲比较麻烦。一个更简单有效的办法是局部更新。只重绘变化的部分在绘制方块前记录方块上一帧的位置。绘制新方块前先用背景色或空格在旧位置“擦除”旧的方块。然后在新的位置绘制方块。对于地图只有方块固化或消行后地图才发生变化。固化时只需在固化位置重绘地图格子消行时需要重绘受影响的行。使用光标定位函数我们之前实现的Renderer::gotoXY就是用来精确定位光标只修改需要修改的字符避免全屏刷新。这是消除闪烁的关键。5.3 输入处理不灵敏或“粘键”问题描述按下键没反应或者按住键只响应一次不能连续移动。排查与解决使用Windows API处理输入_kbhit()和_getch()是标准库函数在快速循环中可能不够灵敏。对于游戏更好的方式是使用GetAsyncKeyState()API函数。它可以检测按键在“当前时刻”是否被按下。bool isKeyPressed(int vKey) { return (GetAsyncKeyState(vKey) 0x8000) ! 0; }在主循环中你可以这样处理持续按键auto currentTime steady_clock::now(); auto deltaTime duration_castmilliseconds(currentTime - lastInputTime).count(); if (deltaTime inputDelay) { // 设置一个输入延迟比如100毫秒 if (isKeyPressed(VK_LEFT)) { tryMove(-1, 0); lastInputTime currentTime; } // ... 处理其他方向键 }这样按住左键方块会以固定的时间间隔持续左移手感更好。区分首次按下和长按可以设置两个时间阈值。首次按下立即响应之后长按则每隔一定时间响应一次。这需要记录每个按键的状态是否已按下和时间戳。5.4 内存访问越界或程序崩溃问题描述在访问地图数组grid[y][x]时程序偶尔崩溃。排查与解决在碰撞检测函数中加入边界断言在计算gridX和gridY后访问数组前先判断索引是否有效。bool Board::isCellEmpty(int x, int y) const { // 先检查边界 if (x 0 || x width || y 0 || y height) { return false; // 对于俄罗斯方块超出边界视为“不空”即碰撞 } return grid[y][x] 0; }注意y可能小于0方块的一部分还在顶部尚未进入可视区域这不应被视为碰撞否则新方块无法出现。通常我们只检查y height和grid[y][x] ! 0。使用std::vector的at()方法调试在开发阶段可以使用grid.at(y).at(x)来访问元素它会进行边界检查如果越界会抛出std::out_of_range异常帮助你快速定位问题。稳定后可以换回operator[]以提高性能。仔细检查形状表坐标确保形状的局部坐标偏移量不会导致绝对坐标出现非常大的负数或正数从而引发不可预料的访问。5.5 方块“穿墙”或“穿块”问题描述方块可以移动到地图外或者穿过已经固化的方块。排查与解决确保碰撞检测在每次移动/旋转后执行在Game::tryMove和Game::tryRotate中必须先计算新位置然后调用pieceFits内部调用Board::isCellEmpty进行检测只有所有单元的新位置都有效才更新方块的实际位置。检查“固化”逻辑当方块触底后需要立即将其单元写入地图Board::solidifyPiece。确保这个函数正确地将方块类型ID写入对应的grid[y][x]位置。渲染顺序确保先绘制已固化的地图背景再绘制当前活动的方块。如果顺序反了活动方块可能会被背景覆盖看起来像“穿过”了但实际上碰撞检测是正常的。实现一个俄罗斯方块就像完成一次精密的机械组装。每个零件类、函数都必须严丝合缝。当你第一次看到自己写的方块流畅下落、旋转、消行并伴随着分数上涨时那种成就感是无可替代的。这个项目带给你的远不止几行C代码而是一套解决复杂问题的工程化思维方法。从数据结构的定义到算法的实现再到模块间的协作与调试每一步都是宝贵的经验。我建议你在实现基础版本后尝试添加更多功能比如下一个方块预览、保持Hold功能、不同的旋转踢墙规则、甚至音效和更漂亮的图形界面可以尝试用SFML或SDL库。每一次扩展都是对既有代码结构的一次考验和提升。
1. 项目概述为什么是俄罗斯方块如果你正在学习C尤其是刚刚掌握了基础语法正愁找不到一个能串联起所有知识点的实战项目那么“俄罗斯方块”几乎是一个完美的选择。它不像贪吃蛇那样过于简单也不像3D游戏那样需要复杂的图形学和数学知识。它恰到好处地涵盖了C核心的面向对象思想、数据结构、算法逻辑甚至是简单的图形界面编程。更重要的是它的规则清晰逻辑闭环实现一个可玩的版本本身就是一次对编程能力的全面检验。我见过很多新手学完了指针、类、继承但面对一个空白的项目却无从下手。俄罗斯方块这个项目就像一份经典的“试卷”它能清晰地告诉你哪些知识点你真正掌握了哪些还只是停留在书本上。通过亲手解析一份高质量的源码并实现它你不仅能获得一个可以运行、可以炫耀的作品更重要的是你能建立起从需求分析到代码实现的完整思维链条。今天我们就来彻底拆解这个经典项目我会带你从零开始理解其核心架构并一步步实现一个控制台版本的俄罗斯方块过程中遇到的每一个“坑”和技巧我都会毫无保留地分享给你。2. 核心架构与设计思路拆解在动手写代码之前我们必须先想清楚整个游戏的“骨架”。一个俄罗斯方块游戏无论界面多么花哨其核心逻辑都可以抽象为几个相互协作的模块。好的架构能让代码清晰、易维护也便于我们分步实现和调试。2.1 游戏世界的模型地图与方块游戏的核心是一个二维的网格“地图”通常宽10格高20格经典规格。我们可以用一个二维数组比如int map[20][10]来表示。数组中的每个元素代表一个“格子”0表示空非0比如1-7表示已被不同形状的方块占据。方块本身是另一个核心。俄罗斯方块有7种基本形状I, J, L, O, S, T, Z。每种形状由4个小方块我们称之为“方块单元”组成。我们需要一种方式来描述这些形状及其旋转状态。最经典的方法是使用“预定义形状表”。我们可以为每种形状定义4个旋转状态0° 90° 180° 270°每个状态用一个4x4的布尔矩阵或坐标数组来表示。例如T型方块在0度旋转时的坐标相对其中心或某个参考点可能是(0, -1), (-1, 0), (0, 0), (1, 0)。通过改变这些相对坐标就能实现旋转。将方块当前的中心坐标加上这些相对坐标就能得到方块四个单元在地图中的实际位置从而进行碰撞检测和绘制。2.2 核心循环与状态管理游戏运行在一个主循环中这个循环每秒会运行很多次例如60帧。每次循环我们大致做以下几件事处理输入检测玩家按键左、右、下、旋转、瞬间落下。更新游戏状态如果到了该自动下落的时间就让当前方块向下移动一格。根据输入尝试移动或旋转当前方块。在任何移动/旋转/下落操作后进行碰撞检测。如果发生碰撞触底或碰到其他方块则将当前方块“固化”到地图中并检查是否有可以被消除的满行。消除满行并让上面的行下落。生成一个新的随机方块作为当前方块。如果新方块一出现就发生碰撞则游戏结束。渲染输出根据最新的地图和当前方块状态在屏幕上绘制出图形。这个循环是游戏的心脏。我们需要一个变量来代表“当前正在下落的方块”包括它的类型、旋转状态和中心坐标。另一个变量代表“下一个将要出现的方块”用于预览。2.3 面向对象的设计用C实现自然要发挥其面向对象的优势。我们可以设计几个核心类Game类游戏的主控制器包含主循环管理游戏状态是否运行、分数、等级并协调其他对象。Board或Map类封装游戏地图二维数组提供方法用于检查某个位置是否被占用、将方块固化到地图、检查并消除满行等。Tetromino类代表一个俄罗斯方块。属性包括类型、旋转状态、中心坐标。方法包括移动、旋转、绘制自己、检查与地图的碰撞等。Renderer类负责渲染。在控制台版本中就是清屏并在正确位置输出字符如[]代表方块##代表墙壁空格代表空。这为将来升级到图形界面留出了接口。注意在简单的控制台版本中Game和Renderer的逻辑可能会耦合得比较紧。但先有清晰的分层意识对写出好代码至关重要。我们可以先从简单的开始再逐步重构。3. 核心细节解析与实操要点理解了架构我们来深入几个最关键的细节这些地方是新手最容易出错或感到困惑的。3.1 方块的表示与旋转算法如何优雅地表示7种形状及其4种旋转我推荐使用“局部坐标系状态表”的方式。首先我们定义一个Shape枚举类型包含7种形状。然后我们用一个三维数组来存储所有形状的所有旋转状态。这个数组可以这样声明// shapes[shapeType][rotation][blockIndex][xOrY] const int shapes[7][4][4][2] { // I型 { {{0, -1}, {0, 0}, {0, 1}, {0, 2}}, // 0度竖条 {{-1, 0}, {0, 0}, {1, 0}, {2, 0}}, // 90度横条 // ... 180度和270度 }, // J型 // ... };数组的四个维度分别是形状索引、旋转状态索引、方块单元索引0-3、坐标0是x偏移1是y偏移。这里的坐标是相对于方块“中心点”或某个“旋转原点”的偏移量。旋转的实现当玩家按下旋转键时我们获取当前方块的下一个旋转状态的偏移量数组计算新的位置并进行碰撞检测。如果旋转后发生碰撞许多现代游戏会尝试进行“踢墙”操作——即轻微调整方块的位置向左/右/上移动一格后再尝试旋转如果仍碰撞则旋转失败。我们在初版可以先不做踢墙以简化逻辑。实操心得定义这个形状表时务必在纸上画好每个形状每个旋转状态的网格图标清中心点和每个单元的偏移。这是整个游戏的数据基石一旦出错方块会显示和旋转得非常诡异。建议编写一个简单的测试函数打印出每个形状每个状态的坐标来验证。3.2 碰撞检测的逻辑碰撞检测是游戏逻辑正确性的保障。在以下操作前必须进行方块尝试向左/右/下移动。方块尝试旋转。方块自动下落。检测函数bool checkCollision(const Tetromino t, const Board b)的大致逻辑是遍历当前方块t的四个单元计算它们在地图b上的实际坐标(gridX, gridY)。判断条件gridX是否超出地图左边界0或右边界宽度gridY是否超出地图下边界高度(上边界一般不会碰到除非游戏结束)如果坐标在地图范围内该位置在地图数组中的值是否为非0已被固化方块占据以上任何条件为真即发生碰撞。关于“触底”当下落碰撞检测发生时如果是因为gridY 高度超出下边界导致的碰撞就是触底。触底后方块需要被固化。3.3 消行与地图更新当方块固化后我们需要检查地图的每一行是否被填满。一个高效的检查方法是遍历每一行判断该行所有格子是否都为非0。消行后上面的行需要下落。一个经典的错误是自上而下地处理如果你从第0行开始消除第2行后把第1行复制到第2行但第1行本身可能也需要下落逻辑就乱了。正确的做法是自下而上处理从地图最底部一行开始向上遍历。如果当前行是满行则消除比如将该行所有元素设为0。设置一个“写入指针”初始指向最底部。再次自下而上遍历但这次只将“非空行”即不全为0的行复制到“写入指针”指向的行然后写入指针上移一行。遍历结束后写入指针以上的所有行都应该被清零因为它们是空出来的区域。这个过程模拟了“消除一行上面所有行整体下落一格”的物理效果。void Board::clearLines(int linesCleared) { linesCleared 0; int writeRow HEIGHT - 1; // 从最底部开始写入 for (int row HEIGHT - 1; row 0; --row) { if (isRowFull(row)) { // 当前是满行跳过不写入相当于消除 linesCleared; } else { // 当前不是满行将其复制到writeRow位置 if (writeRow ! row) { for (int col 0; col WIDTH; col) { grid[writeRow][col] grid[row][col]; } } writeRow--; } } // 清除顶部空出来的行writeRow以上的行 for (int row writeRow; row 0; --row) { for (int col 0; col WIDTH; col) { grid[row][col] 0; } } }4. 控制台版本的实战实现步骤我们现在用Windows下的控制台来实现一个基础版本。我们将使用windows.h中的一些函数来控制光标位置和颜色让游戏看起来更美观。4.1 环境准备与项目结构首先确保你有一个C开发环境比如Visual Studio、Code::Blocks或VSCode配合MinGW。创建一个新的控制台应用项目。建议的项目文件结构TetrisConsole/ ├── main.cpp // 程序入口游戏主循环 ├── Game.h/cpp // Game类定义 ├── Board.h/cpp // Board类定义 ├── Tetromino.h/cpp // Tetromino类定义 ├── Renderer.h/cpp // 渲染器类定义 └── common.h // 公共常量、枚举定义在common.h中我们先定义一些全局常量// common.h #pragma once const int BOARD_WIDTH 10; const int BOARD_HEIGHT 20; const int BOARD_OFFSET_X 5; // 地图在控制台中的起始X坐标 const int BOARD_OFFSET_Y 2; // 地图在控制台中的起始Y坐标 enum class ShapeType { I, J, L, O, S, T, Z }; enum class GameState { PLAYING, PAUSED, GAME_OVER };4.2 核心类实现详解1. Board类Board类负责维护游戏地图状态。// Board.h #pragma once #include common.h #include vector class Board { private: std::vectorstd::vectorint grid; // 使用vector便于动态尺寸这里固定为HEIGHT*WIDTH int width, height; public: Board(int w, int h); void init(); // 初始化空地图 bool isCellEmpty(int x, int y) const; bool isRowFull(int row) const; int clearLines(); // 返回消除的行数 void solidifyPiece(int shapeId, const std::vectorstd::pairint, int cells); const std::vectorstd::vectorint getGrid() const { return grid; } // ... 其他辅助方法 };在Board.cpp中实现clearLines方法逻辑如前所述。2. Tetromino类Tetromino类代表一个活动的方块。// Tetromino.h #pragma once #include common.h #include utility #include vector class Tetromino { private: ShapeType type; int rotation; // 0-3 int posX, posY; // 中心点在地图上的坐标 static const int shapes[7][4][4][2]; // 形状表声明 public: Tetromino(ShapeType t); void reset(ShapeType t, int startX, int startY); std::vectorstd::pairint, int getCurrentCells() const; // 获取当前四个单元的绝对坐标 void move(int dx, int dy); void rotate(); void setRotation(int r) { rotation r; } // ... getters };getCurrentCells方法是关键它根据type,rotation,posX,posY和预定义的shapes表计算出四个方块单元在地图上的实际坐标。3. Renderer类控制台专用控制台渲染的核心是定位光标和设置颜色。我们将使用Windows API。// Renderer.h #pragma once #include common.h #include Board.h #include Tetromino.h #include windows.h class ConsoleRenderer { private: HANDLE hConsole; COORD getConsoleCoord(int boardX, int boardY); // 将地图坐标转换为控制台坐标 public: ConsoleRenderer(); void clearScreen(); void drawBoard(const Board board); void drawPiece(const Tetromino piece); void drawBorders(); void drawInfo(int score, int level, Tetromino nextPiece); void gotoXY(int x, int y); };在构造函数中我们可以获取控制台句柄hConsole GetStdHandle(STD_OUTPUT_HANDLE);。drawBoard函数会遍历地图数组在非空位置绘制彩色方块使用SetConsoleTextAttribute设置颜色。4. Game类Game类是整个游戏的驱动器。// Game.h #pragma once #include common.h #include Board.h #include Tetromino.h #include Renderer.h #include chrono class Game { private: Board board; Tetromino currentPiece; Tetromino nextPiece; ConsoleRenderer renderer; GameState state; int score; int level; int linesCleared; std::chrono::steady_clock::time_point lastFallTime; int getFallInterval() const; // 根据等级计算下落间隔(毫秒) void processInput(); void update(); void render(); void spawnNewPiece(); bool pieceFits(const Tetromino piece) const; public: Game(); void run(); // 主游戏循环 };4.3 主循环与时间控制游戏主循环Game::run()是核心。我们不能让循环无限制地空转那样会占满CPU。我们需要一个基于时间的更新机制。void Game::run() { using namespace std::chrono; lastFallTime steady_clock::now(); auto lastRenderTime lastFallTime; while (state ! GameState::GAME_OVER) { auto currentTime steady_clock::now(); // 1. 处理输入非阻塞 processInput(); // 2. 更新游戏状态 auto deltaTime duration_castmilliseconds(currentTime - lastFallTime).count(); if (deltaTime getFallInterval()) { update(); // 这个update里处理自动下落 lastFallTime currentTime; } // 3. 渲染控制渲染帧率比如每秒60帧 auto renderDelta duration_castmilliseconds(currentTime - lastRenderTime).count(); if (renderDelta 16) { // 约60 FPS render(); lastRenderTime currentTime; } // 短暂休眠避免CPU占用率100% Sleep(1); } // 游戏结束后的处理 renderer.gotoXY(0, BOARD_HEIGHT 5); std::cout 游戏结束最终得分: score std::endl; }processInput函数需要使用非阻塞的方式检测键盘输入。在Windows控制台可以用_kbhit()和_getch()来实现。void Game::processInput() { if (_kbhit()) { int ch _getch(); // 有些键如方向键是双字节第一个字节是0或224 if (ch 0xE0 || ch 0) { ch _getch(); // 获取第二个字节 switch (ch) { case 75: // 左箭头 tryMove(-1, 0); break; case 77: // 右箭头 tryMove(1, 0); break; case 80: // 下箭头 tryMove(0, 1); break; case 72: // 上箭头旋转 tryRotate(); break; } } else { switch (ch) { case : // 空格键瞬间落下 hardDrop(); break; case p: case P: // 暂停 togglePause(); break; case q: case Q: // 退出 state GameState::GAME_OVER; break; } } } }4.4 积分与等级系统一个完整的游戏需要有反馈。经典的积分规则是消除1行100分 * 当前等级消除2行300分 * 当前等级消除3行500分 * 当前等级消除4行Tetris800分 * 当前等级等级随着消除的总行数增加而提升例如每消除10行升一级。等级提高后方块自动下落的速度会加快getFallInterval()返回值变小。在Game::update()中当方块固化并消除行后调用计分函数更新score和level。5. 常见问题与排查技巧实录即使思路清晰实际编码中也会遇到各种“坑”。下面是我在实现过程中遇到的一些典型问题及解决方法。5.1 方块旋转时“卡墙”或位置偏移问题描述实现旋转后方块有时会嵌到墙里或其他方块里或者旋转中心飘忽不定。排查与解决检查形状表坐标这是最常见的原因。确保你的4x4局部坐标定义正确。一个技巧是在纸上画一个4x4网格中心点设为(0,0)。把你定义的四个偏移坐标标上去看是否构成你想要的形状。为每种形状的每种旋转都做这个检查。验证坐标转换在Tetromino::getCurrentCells()函数中打印出计算出的绝对坐标。手动计算几个案例看是否与预期相符。确保你在计算绝对坐标时是中心X 偏移X,中心Y 偏移Y。理解旋转中心俄罗斯方块的旋转并非总是绕几何中心。对于某些形状如I型官方游戏有特殊的旋转规则。如果你要实现完全经典的体验可能需要查阅更详细的“旋转系统”资料如SRSSuper Rotation System。对于第一个版本可以先用简单的绕中心旋转体验基本正确即可。5.2 控制台闪烁严重问题描述游戏画面更新时整个屏幕频繁闪烁体验很差。排查与解决 控制台闪烁是因为我们频繁地清屏system(“cls”)和重绘整个画面。双缓冲技术在控制台中实现真正的双缓冲比较麻烦。一个更简单有效的办法是局部更新。只重绘变化的部分在绘制方块前记录方块上一帧的位置。绘制新方块前先用背景色或空格在旧位置“擦除”旧的方块。然后在新的位置绘制方块。对于地图只有方块固化或消行后地图才发生变化。固化时只需在固化位置重绘地图格子消行时需要重绘受影响的行。使用光标定位函数我们之前实现的Renderer::gotoXY就是用来精确定位光标只修改需要修改的字符避免全屏刷新。这是消除闪烁的关键。5.3 输入处理不灵敏或“粘键”问题描述按下键没反应或者按住键只响应一次不能连续移动。排查与解决使用Windows API处理输入_kbhit()和_getch()是标准库函数在快速循环中可能不够灵敏。对于游戏更好的方式是使用GetAsyncKeyState()API函数。它可以检测按键在“当前时刻”是否被按下。bool isKeyPressed(int vKey) { return (GetAsyncKeyState(vKey) 0x8000) ! 0; }在主循环中你可以这样处理持续按键auto currentTime steady_clock::now(); auto deltaTime duration_castmilliseconds(currentTime - lastInputTime).count(); if (deltaTime inputDelay) { // 设置一个输入延迟比如100毫秒 if (isKeyPressed(VK_LEFT)) { tryMove(-1, 0); lastInputTime currentTime; } // ... 处理其他方向键 }这样按住左键方块会以固定的时间间隔持续左移手感更好。区分首次按下和长按可以设置两个时间阈值。首次按下立即响应之后长按则每隔一定时间响应一次。这需要记录每个按键的状态是否已按下和时间戳。5.4 内存访问越界或程序崩溃问题描述在访问地图数组grid[y][x]时程序偶尔崩溃。排查与解决在碰撞检测函数中加入边界断言在计算gridX和gridY后访问数组前先判断索引是否有效。bool Board::isCellEmpty(int x, int y) const { // 先检查边界 if (x 0 || x width || y 0 || y height) { return false; // 对于俄罗斯方块超出边界视为“不空”即碰撞 } return grid[y][x] 0; }注意y可能小于0方块的一部分还在顶部尚未进入可视区域这不应被视为碰撞否则新方块无法出现。通常我们只检查y height和grid[y][x] ! 0。使用std::vector的at()方法调试在开发阶段可以使用grid.at(y).at(x)来访问元素它会进行边界检查如果越界会抛出std::out_of_range异常帮助你快速定位问题。稳定后可以换回operator[]以提高性能。仔细检查形状表坐标确保形状的局部坐标偏移量不会导致绝对坐标出现非常大的负数或正数从而引发不可预料的访问。5.5 方块“穿墙”或“穿块”问题描述方块可以移动到地图外或者穿过已经固化的方块。排查与解决确保碰撞检测在每次移动/旋转后执行在Game::tryMove和Game::tryRotate中必须先计算新位置然后调用pieceFits内部调用Board::isCellEmpty进行检测只有所有单元的新位置都有效才更新方块的实际位置。检查“固化”逻辑当方块触底后需要立即将其单元写入地图Board::solidifyPiece。确保这个函数正确地将方块类型ID写入对应的grid[y][x]位置。渲染顺序确保先绘制已固化的地图背景再绘制当前活动的方块。如果顺序反了活动方块可能会被背景覆盖看起来像“穿过”了但实际上碰撞检测是正常的。实现一个俄罗斯方块就像完成一次精密的机械组装。每个零件类、函数都必须严丝合缝。当你第一次看到自己写的方块流畅下落、旋转、消行并伴随着分数上涨时那种成就感是无可替代的。这个项目带给你的远不止几行C代码而是一套解决复杂问题的工程化思维方法。从数据结构的定义到算法的实现再到模块间的协作与调试每一步都是宝贵的经验。我建议你在实现基础版本后尝试添加更多功能比如下一个方块预览、保持Hold功能、不同的旋转踢墙规则、甚至音效和更漂亮的图形界面可以尝试用SFML或SDL库。每一次扩展都是对既有代码结构的一次考验和提升。
