企业官网建设流程全解析

简介：这是一份面向C++初学者与编程爱好者的实践型学习资源，聚焦基础语法巩固与小型项目开发能力培养，通过可运行的小游戏快速理解类、对象、循环、随机数、状态控制等核心概念。资源包共117个文件，含115个.cpp源码文件（涵盖迷宫、猜数字、井字棋、龙的传人、勇士之战、狼人杀、国粹麻将等多样化项目）、1个可执行exe文件及1个编译输出out文件，整体仅1.13MB，轻量易解压，适合本地调试与代码逐行研读。已有10613人学习下载，热度高、实操反馈丰富。每个游戏均为独立完整项目，结构清晰、注释友好，既可作为课堂练习范例，也支持二次开发——如添加图形界面、优化AI逻辑或拓展网络对战功能，是夯实C++面向对象思维与工程化编码习惯的优质入门素材。

1. 为什么“一个免费的C++小游戏集合”不是玩具包，而是C++工程能力的压缩包？

你点开 GitHub 或 Gitee 上标着「免费 C++ 小游戏集合」的仓库时，大概率会先扫一眼 star 数、最后更新时间，然后下意识点开main.cpp——结果发现：没有 CMakeLists.txt，头文件全用绝对路径，#include "D:\dev\game\src\player.h"这种写法赫然在列；或者更糟：所有逻辑挤在单个.cpp里，main()函数长达 800 行，中间穿插着goto menu_loop;和三重嵌套for (int i=0; i<10; i++) for (int j=0; j<10; j++) for (int k=0; k<4; k++)。这不是教学资源，这是工程反模式现场。

但反过来看，真正能跑通、可调试、有结构、带注释的免费 C++ 小游戏集合，恰恰是新手突破语法→工程→架构认知断层最扎实的跳板。它不依赖图形引擎黑盒（比如 Unity 的 Inspector 玄学），所有渲染靠sfml或raylib的裸 API 调用，内存管理靠std::vector和 RAII 显式控制，输入事件靠while (window.pollEvent(event))一帧一帧手动泵——你改一行代码，画面就动一下；你漏一个delete，Valgrind 就报错给你看。这不是玩具，这是 C++ 的「解剖台」：把面向对象、资源生命周期、事件循环、状态机这些概念，焊死在 200~500 行的真实可执行体里。适合刚写完《C++ Primer》习题、对着std::unique_ptr发呆、但还不敢碰 Qt 或 Unreal 的人——用贪吃蛇理解std::deque的 O(1) 插入删除，用推箱子验证std::map<std::pair<int,int>, char>的坐标映射逻辑，用俄罗斯方块的旋转矩阵亲手实现std::array<std::array<bool, 4>, 4>的 90° 顺时针翻转。下面我们就从零开始，搭一个真正能进 IDE 调试、能改能扩、能当简历项目的 C++ 小游戏集合骨架。

2. 用 CMake + SFML 搭建跨平台可调试的小游戏集合骨架

2.1 为什么选 SFML 而不是 SDL2 或 raylib？三个硬指标决定取舍

新手常纠结图形库选型。我们不用「哪个更好」这种玄学话术，只看三个硬指标：Windows/macOS/Linux 三端编译一次通过率、VS Code/CLion 下断点调试成功率、新手改出第一帧动画所需最小代码行数。实测数据如下（基于 2024 年主流发行版）：

结论很直接：SFML 是唯一在三端零配置、IDE 断点即停、且最小示例足够薄的选项。它的设计哲学就是「让 C++ 新手第一眼就看到对象和方法」——sf::RenderWindow window(...)是对象，.clear().display()是方法，.pollEvent()返回sf::Event结构体，所有类型都带sf::命名空间前缀，杜绝宏污染。这比 SDL2 的SDL_Window*指针裸奔、或 raylib 的全局状态机（IsKeyDown()直接读全局）更适合建立 C++ 工程直觉。

提示：不要下载官网的「Visual Studio Integration」安装包——它会往系统注册表塞东西，且与现代 CMake 冲突。正确做法是直接下载SFML-2.6.1-windows-vc17-64-bit.zip，解压后只保留include/和lib/目录，后续由 CMake 自动定位。

2.2 用 CMake 构建可扩展的多游戏项目结构：从单 exe 到模块化

一个「集合」必须支持快速增删游戏，不能每次加个新游戏就重写main()。我们采用「主程序驱动 + 游戏插件接口」结构，核心是定义一个纯虚基类Game，所有具体游戏继承它：

// include/game_base.h #pragma once #include <SFML/Graphics.hpp> class Game { public: virtual ~Game() = default; // 生命周期钩子：初始化资源 virtual bool init(sf::RenderWindow& window) = 0; // 主循环：返回 false 表示退出游戏 virtual bool update(float deltaTime) = 0; // 渲染 virtual void render(sf::RenderWindow& window) = 0; // 键盘/鼠标事件处理 virtual void handleEvent(const sf::Event& event) = 0; };

项目目录结构强制分层：

games-collection/ ├── CMakeLists.txt # 根 CMake：定义编译选项、查找 SFML ├── src/ │ ├── main.cpp # 主循环：创建 window，调用当前 game 的钩子 │ └── games/ # 所有游戏实现放这里 │ ├── snake/ # 每个游戏独立子目录 │ │ ├── CMakeLists.txt # 子 CMake：编译为静态库 snake_lib │ │ ├── snake_game.h │ │ └── snake_game.cpp │ └── tetris/ │ ├── CMakeLists.txt │ ├── tetris_game.h │ └── tetris_game.cpp └── include/ └── game_base.h # 基类声明

根CMakeLists.txt关键段（省略注释）：

# cmake_minimum_required(VERSION 3.10) project(games_collection LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 查找 SFML（自动适配 Windows/macOS/Linux） find_package(sfml 2.6 COMPONENTS graphics window system REQUIRED) # 定义可执行文件 add_executable(games_collection src/main.cpp) # 添加所有子目录（每个子目录有自己的 CMakeLists.txt） add_subdirectory(src/games/snake) add_subdirectory(src/games/tetris) # 链接 SFML 和各游戏库 target_link_libraries(games_collection sfml-graphics sfml-window sfml-system snake_lib tetris_lib ) # 复制资源文件（如字体、图片）到输出目录 file(COPY assets/fonts/ DESTINATION $<TARGET_FILE_DIR:games_collection>/fonts)

每个游戏子目录的CMakeLists.txt（以 snake 为例）：

# src/games/snake/CMakeLists.txt add_library(snake_lib STATIC snake_game.h snake_game.cpp ) # 公共头文件路径对主程序可见 target_include_directories(snake_lib PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/..) # 链接 SFML（避免主 CMake 重复链接） target_link_libraries(snake_lib sfml-graphics sfml-window sfml-system)

这样做的好处是：加新游戏只需三步——① 在src/games/下建新目录；② 写CMakeLists.txt声明add_library(xxx_lib ...)；③ 在根CMakeLists.txt中add_subdirectory()。无需碰main.cpp，编译器自动合并所有xxx_lib。更重要的是，每个游戏库可独立单元测试（后面章节详述）。

2.3 main.cpp：一个永不修改的主循环胶水层

src/main.cpp是整个集合的「操作系统内核」，它只做四件事：创建窗口、选择当前游戏、驱动游戏生命周期、处理全局退出逻辑。这个文件一旦写好，后续所有游戏开发都不需要再动它——这是工程稳定性的基石。

// src/main.cpp #include <SFML/Graphics.hpp> #include <memory> #include <iostream> #include "include/game_base.h" // 声明具体游戏类（此处仅前向声明，避免 include 循环） class SnakeGame; class TetrisGame; int main() { // 1. 创建窗口（800x600，抗锯齿） sf::ContextSettings settings; settings.antialiasingLevel = 8; sf::RenderWindow window(sf::VideoMode(800, 600), "Games Collection", sf::Style::Close, settings); window.setFramerateLimit(60); // 2. 实例化当前游戏（此处硬编码，实际可用命令行参数或菜单切换） std::unique_ptr<Game> currentGame = std::make_unique<SnakeGame>(); // 3. 初始化游戏 if (!currentGame->init(window)) { std::cerr << "Game initialization failed!" << std::endl; return -1; } // 4. 主循环：固定时间步长 + 事件泵 sf::Clock clock; while (window.isOpen()) { float deltaTime = clock.restart().asSeconds(); // 每帧耗时（秒） // 处理系统事件（关闭窗口、焦点丢失等） sf::Event event; while (window.pollEvent(event)) { if (event.type == sf::Event::Closed) { window.close(); } // 将事件转发给当前游戏 currentGame->handleEvent(event); } // 更新游戏逻辑（deltaTime 用于帧率无关运动） if (!currentGame->update(deltaTime)) { break; // 游戏主动请求退出（如按 ESC） } // 渲染 window.clear(sf::Color::Black); currentGame->render(window); window.display(); } return 0; }

关键设计点说明：

• std::unique_ptr<Game>确保游戏对象在栈上安全销毁，避免new/delete手动管理；
• deltaTime传入update()，让移动速度与帧率解耦（position += velocity * deltaTime），否则在不同机器上速度天差地别；
• window.pollEvent()在循环内，保证每帧处理全部待处理事件，避免事件积压；
• currentGame->update()返回bool：false表示游戏结束（如贪吃蛇撞墙），主循环自动跳出，无需exit(0)粗暴终止。

这个main.cpp的价值在于：它把「游戏是什么」这个哲学问题，降维成一个 C++ 接口契约。只要新游戏实现了Game的四个纯虚函数，它就能无缝接入集合——这才是「集合」二字的技术含义。

3. 用贪吃蛇实战：把 std::deque 和 RAII 变成肌肉记忆

3.1 蛇身数据结构：为什么不用 vector 而用 deque？性能与语义的双重胜利

贪吃蛇的蛇身本质是「头插、尾删」的线性序列。新手第一反应是std::vector<Point>，但这是典型的时间复杂度陷阱：vector.push_back()是均摊 O(1)，但vector.insert(vector.begin(), new_head)是 O(n) —— 每次蛇头前进都要移动所有后续节点。而std::deque（双端队列）的push_front()和pop_back()都是严格 O(1)，且内存布局对缓存友好（分段连续，非完全连续）。

更重要的是语义清晰：deque天然表达「蛇有头有尾」的物理概念。我们定义蛇身结构：

// src/games/snake/snake_game.h #pragma once #include <SFML/Graphics.hpp> #include <deque> #include <random> #include "include/game_base.h" struct Point { int x, y; Point(int x = 0, int y = 0) : x(x), y(y) {} bool operator==(const Point& other) const { return x == other.x && y == other.y; } }; class SnakeGame : public Game { private: std::deque<Point> body; // 蛇身：front() 是头，back() 是尾 Point direction{1, 0}; // 当前移动方向（1,0）= 向右 Point food; // 食物位置 sf::RectangleShape segment; // 蛇身/食物的渲染单元（RAII 封装） sf::Font font; // 字体（RAII：构造时加载，析构时释放） sf::Text scoreText; // 分数文本 int score{0}; mutable std::mt19937 rng; // 可变 RNG（generateFood 需修改状态） void generateFood(); // 生成不与蛇身重叠的食物 bool checkCollision() const; // 检查蛇头是否撞墙或撞自己 void moveSnake(); // 根据 direction 移动蛇身 public: SnakeGame() : rng(std::random_device{}()) {} // RNG 初始化 bool init(sf::RenderWindow& window) override; bool update(float deltaTime) override; void render(sf::RenderWindow& window) override; void handleEvent(const sf::Event& event) override; };

注意mutable std::mt19937 rng：generateFood()是const成员函数（不改变游戏逻辑状态），但需要修改 RNG 内部状态，故用mutable修饰。这是 C++ 中少数合理使用mutable的场景——它把「随机数生成」这个副作用，明确限定在 RNG 对象内部，而非污染整个generateFood()的语义。

3.2 RAII 实践：字体、纹理、声音的自动生命周期管理

SFML 的资源（sf::Font,sf::Texture,sf::SoundBuffer）必须在使用前加载，且加载失败会抛异常。新手常写：

// ❌ 危险！未检查加载结果，且未封装异常处理 sf::Font font; font.loadFromFile("assets/fonts/arial.ttf"); // 若文件不存在，程序崩溃

正确做法是用 RAII 封装加载逻辑，在构造函数中完成加载，并在析构时确保资源释放：

// src/games/snake/snake_game.cpp #include "snake_game.h" #include <stdexcept> #include <iostream> bool SnakeGame::init(sf::RenderWindow& window) { try { // RAII 加载字体：构造即加载，失败抛 std::runtime_error if (!font.loadFromFile("assets/fonts/arial.ttf")) { throw std::runtime_error("Failed to load font: arial.ttf"); } // 初始化渲染单元：设置大小、颜色、原点（居中锚点） segment.setSize({20, 20}); segment.setFillColor(sf::Color::Green); segment.setOrigin({10, 10}); // 原点设为矩形中心，方便旋转/缩放 // 初始化分数文本 scoreText.setFont(font); scoreText.setCharacterSize(24); scoreText.setFillColor(sf::Color::White); scoreText.setPosition({10, 10}); // 生成初始蛇身（3 节，水平排列） body.clear(); for (int i = 0; i < 3; ++i) { body.emplace_back(10 - i, 10); // (10,10), (9,10), (8,10) } generateFood(); // 首次生成食物 score = 0; return true; } catch (const std::exception& e) { std::cerr << "SnakeGame::init error: " << e.what() << std::endl; return false; } }

sf::Font和sf::RectangleShape的析构函数会自动释放底层资源，无需手动delete。这就是 RAII 的力量：资源获取即初始化（Resource Acquisition Is Initialization），你只管构造，析构器自动兜底。对比 C 风格的SDL_LoadBMP()+SDL_FreeSurface()手动配对，C++ 的 RAII 让资源泄漏成为历史。

3.3 事件处理与状态机：用枚举管理游戏状态，拒绝 if-else 泥潭

贪吃蛇有明确状态：运行中、暂停、游戏结束。新手常写：

// ❌ 状态混杂在 update() 中，难以维护 if (isPaused) { /* 处理暂停逻辑 */ } else if (isGameOver) { /* 处理结束逻辑 */ } else { /* 正常更新 */ }

更好的方式是定义状态枚举，并在handleEvent()中集中响应用户输入切换状态：

// src/games/snake/snake_game.h enum class GameState { Running, Paused, GameOver }; class SnakeGame : public Game { private: GameState state{GameState::Running}; // ... 其他成员 public: void handleEvent(const sf::Event& event) override { if (event.type == sf::Event::KeyPressed) { switch (state) { case GameState::Running: handleRunningKey(event.key.code); break; case GameState::Paused: if (event.key.code == sf::Keyboard::Escape) { state = GameState::Running; // 按 ESC 继续 } break; case GameState::GameOver: if (event.key.code == sf::Keyboard::Return) { resetGame(); // 按回车重开 } break; } } } private: void handleRunningKey(sf::Keyboard::Key key) { // 方向键控制（忽略对角线冲突） if (key == sf::Keyboard::Up && direction != Point{0, 1}) { direction = {0, -1}; } else if (key == sf::Keyboard::Down && direction != Point{0, -1}) { direction = {0, 1}; } else if (key == sf::Keyboard::Left && direction != Point{1, 0}) { direction = {-1, 0}; } else if (key == sf::Keyboard::Right && direction != Point{-1, 0}) { direction = {1, 0}; } else if (key == sf::Keyboard::Escape) { state = GameState::Paused; } } void resetGame() { body.clear(); for (int i = 0; i < 3; ++i) { body.emplace_back(10 - i, 10); } direction = {1, 0}; generateFood(); score = 0; state = GameState::Running; } };

update()中只处理状态相关的逻辑：

bool SnakeGame::update(float deltaTime) { switch (state) { case GameState::Running: moveSnake(); if (checkCollision()) { state = GameState::GameOver; return true; // 继续循环，显示 Game Over 文本 } // 检查吃食物 if (body.front() == food) { score += 10; generateFood(); // 蛇身增长：在尾部插入一个与尾部相同的位置 body.push_back(body.back()); } break; case GameState::Paused: // 暂停时不更新逻辑，只等待按键 break; case GameState::GameOver: // 游戏结束状态，等待用户按回车 break; } return true; // true 表示继续主循环 }

这种状态机写法的好处是：逻辑隔离、可测试、易扩展。要加「无敌模式」？只需新增GameState::Invincible枚举值，并在handleRunningKey()中加一个if (key == sf::Keyboard::I)分支。所有状态变更都在handleEvent()中，update()只专注计算，render()只专注绘制——单一职责原则落地。

4. 常见问题排查：那些让你编译通过却运行崩溃的隐形坑

4.1 现象：Windows 下程序一闪而退，控制台无任何输出

原因：SFML 窗口程序默认是WinMain入口，不连接控制台，std::cout输出被静默丢弃；同时，若init()中font.loadFromFile()失败，throw的异常未被捕获，程序直接终止。
解决：
① 在CMakeLists.txt中强制启用控制台（即使 GUI 程序）：

# 在 target_link_libraries 之后添加 if(WIN32) set_target_properties(games_collection PROPERTIES LINK_FLAGS "/SUBSYSTEM:CONSOLE") endif()

② 在main()中捕获顶层异常：

int main() { try { // 原有所有代码 } catch (const std::exception& e) { std::cerr << "Fatal error: " << e.what() << std::endl; std::cin.get(); // 暂停，防止窗口闪退 return -1; } return 0; }

4.2 现象：macOS 上编译通过，运行时报dyld: Library not loaded: @rpath/libsfml-graphics.2.6.dylib

原因：macOS 的动态库路径（@rpath）未正确设置，系统找不到 SFML 动态库。
解决：
① 使用install_name_tool修复可执行文件的 rpath（在CMakeLists.txt中添加）：

if(APPLE) # 设置 rpath 为可执行文件所在目录 set_target_properties(games_collection PROPERTIES BUILD_RPATH "@executable_path/../Frameworks") # 将 SFML 库复制到 Frameworks 目录（需提前准备） add_custom_command(TARGET games_collection POST_BUILD COMMAND ${CMAKE_COMMAND} -E make_directory $<TARGET_FILE_DIR:games_collection>/Frameworks COMMAND ${CMAKE_COMMAND} -E copy_if_different $<TARGET_FILE:SFML::sfml-graphics> $<TARGET_FILE_DIR:games_collection>/Frameworks/ COMMAND ${CMAKE_COMMAND} -E copy_if_different $<TARGET_FILE:SFML::sfml-window> $<TARGET_FILE_DIR:games_collection>/Frameworks/ COMMAND ${CMAKE_COMMAND} -E copy_if_different $<TARGET_FILE:SFML::sfml-system> $<TARGET_FILE_DIR:games_collection>/Frameworks/ ) endif()

② 更简单方案：静态链接 SFML（推荐新手），在find_package后添加：

set(CMAKE_FIND_LIBRARY_SUFFIXES ".a${CMAKE_FIND_LIBRARY_SUFFIXES}") find_package(sfml 2.6 COMPONENTS graphics window system REQUIRED CONFIG)

并确保下载的是 SFML 的静态库版本（SFML-2.6.1-macos-clang-generic-static-64bit.tar.gz）。

4.3 现象：Linux 下make报错undefined reference to 'sf::Font::loadFromFile(std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> > const&)'

原因：GCC 版本升级后 ABI 不兼容（_GLIBCXX_USE_CXX11_ABI=1），而预编译的 SFML 库是旧 ABI 编译的。
解决：
① 强制使用旧 ABI（不推荐，影响其他库）：

g++ -D_GLIBCXX_USE_CXX11_ABI=0 ...

②正确做法：源码编译 SFML（一劳永逸）：

wget https://www.sfml-dev.org/files/SFML-2.6.1-sources.zip unzip SFML-2.6.1-sources.zip cd SFML-2.6.1 mkdir build && cd build cmake -DCMAKE_BUILD_TYPE=Release -DSFML_BUILD_SHARED_LIBS=FALSE .. make -j$(nproc) sudo make install

然后在项目CMakeLists.txt中find_package(sfml 2.6 REQUIRED CONFIG)即可，CMake 会自动找到你编译的静态库。

4.4 现象：蛇移动时出现「瞬移」或「卡顿」，deltaTime值异常大（如 0.5 秒）

原因：sf::Clock未在循环开始前restart()，或deltaTime被错误地累加而非重置。
解决：
严格遵循main.cpp中的模式：

sf::Clock clock; // 在循环外声明 while (window.isOpen()) { float deltaTime = clock.restart().asSeconds(); // ✅ 每帧重置并获取耗时 // ... update/render }

切勿写成：

float deltaTime = 0; sf::Clock clock; while (...) { deltaTime += clock.restart().asSeconds(); // ❌ 累加！导致 deltaTime 越来越大 }

restart()返回自上次调用以来的耗时，且重置内部计时器——这是 SFML Clock 的正确用法。

4.5 现象：std::deque在moveSnake()中push_front()后，body.size()突然变为 0

原因：body成员变量被意外重新赋值（如body = std::deque<Point>();），或SnakeGame对象被拷贝（std::deque的拷贝构造是深拷贝，但若类中有指针成员则可能浅拷贝）。
解决：
① 检查SnakeGame是否定义了拷贝构造函数/赋值运算符。若无特殊需求，显式删除它们：

class SnakeGame : public Game { public: SnakeGame(const SnakeGame&) = delete; SnakeGame& operator=(const SnakeGame&) = delete; // ... 其他成员 };

② 在moveSnake()中打印调试信息：

void SnakeGame::moveSnake() { std::cout << "Before push_front: size=" << body.size() << std::endl; body.push_front({body.front().x + direction.x, body.front().y + direction.y}); std::cout << "After push_front: size=" << body.size() << std::endl; }

若发现 size 异常，立即检查body是否在别处被清空（如body.clear()调用位置）。

5. 进阶技巧：用 GoogleTest 为每个游戏写单元测试，让重构不再心慌

5.1 为什么小游戏也需要单元测试？一个血泪教训

某开发者曾重构贪吃蛇的碰撞检测逻辑，将checkCollision()从遍历body改为用std::unordered_set<Point>缓存蛇身位置以加速查询。本地测试一切正常，提交后 CI 构建通过，但上线第二天收到大量用户反馈：「蛇穿过墙壁了！」。排查发现：std::unordered_set的哈希函数未正确定义Point的operator==和std::hash<Point>，导致body.front()的位置未被正确插入集合，碰撞检测永远返回false。没有单元测试，这种逻辑缺陷只能靠用户当 QA。

单元测试的价值不是「证明代码正确」，而是「划定修改边界」——当你改moveSnake()时，test_snake_movement.cpp会立刻告诉你：「嘿，你破坏了『蛇头坐标应等于上一帧蛇头 + 方向』这个契约」。

5.2 用 GoogleTest 测试贪吃蛇核心逻辑：不依赖 SFML，纯 C++ 逻辑

GoogleTest 要求测试代码与图形代码分离。我们提取纯逻辑到头文件，测试时只包含它：

// src/games/snake/snake_logic.h #pragma once #include <deque> #include <vector> struct Point { int x, y; }; struct SnakeState { std::deque<Point> body; Point direction; int score; }; // 纯函数：给定当前状态和方向，返回新状态 SnakeState moveSnake(const SnakeState& state, const Point& newDirection); bool checkCollision(const SnakeState& state, int width, int height);

对应的测试文件test/snake_logic_test.cpp：

#include <gtest/gtest.h> #include "src/games/snake/snake_logic.h" TEST(SnakeLogicTest, MoveRightFromInitial) { SnakeState initial; initial.body = {{10,10}, {9,10}, {8,10}}; initial.direction = {1, 0}; initial.score = 0; auto result = moveSnake(initial, {1, 0}); EXPECT_EQ(result.body.size(), 3u); EXPECT_EQ(result.body.front().x, 11); // 头从 (10,10) 移到 (11,10) EXPECT_EQ(result.body.front().y, 10); EXPECT_EQ(result.body.at(1).x, 10); // 第二节到原头位置 } TEST(SnakeLogicTest, CollisionWithWall) { SnakeState state; state.body = {{0,10}}; // 蛇头在左边界 state.direction = {-1, 0}; // 向左移动 EXPECT_TRUE(checkCollision(state, 80, 60)); // 80x60 窗口，x=0 向左撞墙 } TEST(SnakeLogicTest, CollisionWithSelf) { SnakeState state; state.body = {{5,5}, {5,4}, {4,4}, {4,5}}; // 方形，头在 (5,5) state.direction = {0, 1}; // 向下，会撞到 (5,4) EXPECT_TRUE(checkCollision(state, 80, 60)); }

CMake 集成（在根CMakeLists.txt中）：

# 启用测试 enable_testing() # 查找 GoogleTest（需提前 git clone 到 deps/googletest） add_subdirectory(deps/googletest) include(GoogleTest) # 创建测试可执行文件 add_executable(test_snake_logic test/snake_logic_test.cpp) target_link_libraries(test_snake_logic gtest_main) target_include_directories(test_snake_logic PRIVATE src/games/snake) # 注册测试 gtest_add_tests(TARGET test_snake_logic TEST_PREFIX snake. TEST_LIST SnakeLogicTest.MoveRightFromInitial SnakeLogicTest.CollisionWithWall SnakeLogicTest.CollisionWithSelf )

运行测试：

mkdir build && cd build cmake .. -G "Unix Makefiles" # 或 -G "Visual Studio 17 2022" on Windows make ./test_snake_logic # 输出 GoogleTest 格式报告

5.3 测试驱动开发（TDD）实践：先写测试，再写generateFood()

假设我们要实现generateFood()：在 80x60 网格中生成一个不与蛇身重叠的随机点。TDD 步骤：

1. 写失败测试（红）：

TEST(SnakeLogicTest, GenerateFoodNoCollision) { SnakeState state; state.body = {{10,10}, {9,10}}; // 蛇占两个点 Point food = generateFood(state, 80, 60); // 假设此函数存在 // 断言：food 不在 body 中 bool isOnSnake = false; for (const auto& p : state.body) { if (p.x == food.x && p.y == food.y) { isOnSnake = true; break; } } EXPECT_FALSE(isOnSnake); }

2. 写最简实现（绿）：

// src/games/snake/snake_logic.h Point generateFood(const SnakeState& state, int width, int height) { // 简单起见，先返回固定点（测试会失败） return {5, 5}; }

运行测试 → 失败（因为蛇身有(10,10)，但food=(5,5)不冲突，等等… 这个测试其实会通过！说明测试不够严格。于是加一个更狠的测试：

TEST(SnakeLogicTest, GenerateFoodAllGridOccupied) { SnakeState state; // 填满整个 3x3 网格 for (int x = 0; x < 3; ++x) { for (int y = 0; y < 3; ++y) { state.body.emplace_back(x, y); } } // 在 3x3 网格中生成食物 → 必须失败或返回无效点 Point food = generateFood(state, 3, 3); // 我们约定：若无法生成，返回 (-1,-1) EXPECT_EQ(food.x, -1); EXPECT_EQ(food.y, -1); }

3. 实现真实逻辑（重构）：

#include <random> Point generateFood(const SnakeState& state, int width, int height) { std::vector<Point> candidates; for (int x = 0; x < width; ++x) { for (int y = 0; y < height; ++y) { bool occupied = false; for (const auto& p : state.body) { if (p.x == <p> <a href="https://download.csdn.net/download/cmh20120102/88139627" style="color:#ec7500;font-size:14px;"> 本文还有配套的精品资源，点击获取 </a> <img alt="menu-r.4af5f7ec.gif" src="https://csdnimg.cn/release/wenkucmsfe/public/img/menu-r.4af5f7ec.gif" style="width:16px;margin-left:4px;vertical-align:text-bottom;cursor:text;"> </p>