水木年华81. 项目概述与迭代思路
1.1 为什么做寻宝猎人：从1.0到2.0的演进
先聊聊这个项目的来龙去脉。寻宝猎人最早是我在两年前为了练手C++写的一个控制台小游戏，当时只有一张用字符拼出来的地图，一个用WASD移动的P字符，加上随机散落的T字符代表宝箱，碰到就加分。说白了就是"会动的迷宫找宝箱"，整个代码量不超过五百行，但它成功帮我摸清了C++的类设计、循环结构和基本输入输出。
到了2.0版本，我决定不再满足于"能跑就行"，而是从工程化角度重新设计整个项目。这个版本引入了几大变化：地图从静态二维数组升级为动态生成系统，玩家从单一字符变成带朝向的精灵实体，增加了敌人巡逻逻辑、宝箱开启动画、计分与关卡循环，同时把整个代码库拆分成十几个模块文件，彻底告别"一坨.cpp写到底"的写法。2.0的目标就是用一款真正意义完整的游戏项目，把C++的中阶语法点全部串起来，包括STL容器、智能指针、继承多态、甚至一点设计模式。
这个项目的定位非常清晰：写给已经学完C++基础语法、但不知道下一步该干什么的人。很多人学完类和对象就卡住了，看理论书觉得懂了，一写项目就懵。寻宝猎人2.0就是那个"桥梁"——它足够小，一个人两周能啃完；又足够完整，游戏循环、碰撞检测、状态管理、资源加载这些真正游戏开发的核心概念全都能在代码里找到活生生的例子。
1.2 技术选型：为什么用C++写游戏而不是游戏引擎
选C++写游戏，很多人第一反应是"为什么不直接用Unity或者Godot？"这个问题我在项目README里也专门解释过。游戏引擎确实效率高，但也正因为引擎替你做了太多事，很多底层机制反而成了黑盒。用C++从零写游戏逻辑，等于把引擎替你做的事重新学一遍——这恰恰是C++学习者最需要补的课。
具体到技术栈，我做了这么几个决策：
| 技术点 | 选型 | 理由 |
|---|---|---|
| 语言标准 | C++17 | 支持std::optional、结构化绑定，代码更简洁，兼容性也好 |
| 图形接口 | SFML 2.5+ | 跨平台、轻量、API直观，比SDL更适合入门，又比Qt游戏栈更纯粹 |
| 构建工具 | CMake 3.16+ | 跨平台构建的标准方案，配合VSCode一套搞定编译调试 |
| 资源管理 | 自写ResourceManager |
学习资源生命周期管理，比直接塞进全局变量更有工程意义 |
| 版本管理 | Git + Gitee | 开源托管、issue管理、CI示例一条龙 |
图形库这块，我也纠结过到底用SDL还是SFML。SDL更底层，能学到更多"图形上下文""像素缓冲区"这类概念，但代码写起来啰嗦，新手容易迷失在初始化代码里。SFML则是"刚好够用"的抽象层，它帮你封装了窗口创建、事件循环、纹理加载这些基础设施，但你仍然需要自己处理游戏循环的节奏、精灵的绘制顺序、碰撞的体积计算——这些恰恰是游戏编程的核心思维所在。
不用现成引擎还有一个原因：寻宝猎人2.0本身就是一个教学型开源项目，它的价值在于"你能看懂每一行代码，并且能改任何一处逻辑"。用Unity的话，光项目文件结构就能劝退一半初学者。而C++加SFML的工程结构非常透明:main.cpp里是入口，Game.cpp里是主循环，Entity.cpp里是角色逻辑,想改哪里直接跳进对应的源文件就行。
1.3 寻宝猎人2.0的核心玩法设计
设计玩法之前，我列了一个最简单的游戏循环骨架：处理输入 → 更新逻辑 → 渲染画面，这三步以每秒60次的频率重复运行。所有玩法都必须塞进这个骨架的更新阶段里。基于这个约束，寻宝猎人2.0的玩法定稿为三个层次：
第一层是基础寻宝，也就是1.0的核心玩法延续。地图上随机分布若干宝箱坐标，玩家移动到一个宝箱格子，按下交互键即可开启宝箱，获得金币和积分。这一层保证了游戏"可玩"。
第二层是障碍与敌人。地图上添加了墙体、水塘（不可通行）、草丛（可通行但减速）三类地形，敌人则拥有简单的巡逻AI：沿固定路径往返走，当玩家进入指定探测范围后切换为追踪模式，碰到玩家则损失一条命。这一层把游戏从"寻宝模拟器"变成了"有紧张感的策略游戏"。
第三层是关卡循环与成长系统。玩家收集到关卡要求的宝藏数量后，会传送至下一关——地图面积变大、敌人数量变多、巡逻路线更复杂，同时玩家的移速和生命值上限也会小幅提升。这一层确保玩家有持续游玩的动力。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心模块拆解与原理分析
2.1 地图系统：从二维数组到动态瓦片地图
地图系统是游戏世界的地基。1.0版本的地图就是一个硬编码的char map[10][20]，里面塞了'#'代表墙、'.'代表空地。这当然能用，但问题在于：关卡怎么扩展？每次新建关卡都要手写二维数组？宝箱和敌人的位置怎么跟地图文件分离？
2.0版本我采用瓦片地图（Tile Map）加对象层的方案。瓦片地图处理静态地形，用二维容器存储地形枚举；对象层处理动态实体，用一列表格记录每个实体的坐标和类型。两者分离之后，地图的生成和维护都变得非常灵活。
地形类型我用枚举定义，而不是裸字符：
cpp复制enum class TileType {
Floor, Wall, Water, Bush, ExitPortal
};
地图本身是一个std::vector<std::vector<TileType>>，每个关卡的数据可以放在文本文件里通过数字索引加载，也可以由程序运行时生成。为了支持随机生成，我实现了一个简单的房间-隧道算法：先在地图上随机放置若干个不相交的矩形房间，然后用水平加垂直的L形隧道把相邻