游戏客户端架构 / 系统课时
准备开发工具
准备开发工具
本课将搭建二维引擎开发所需的基础工具链,并通过版本、编译和调试检查确认环境可用。完成后,你会得到一个能够编译 C++、启动调试会话并提交 Git 版本的最小开发环境。
学习目标
- 安装并确认 C++ 编译器与调试器可用
- 配置代码编辑器和常用扩展
- 用最小程序验证编译、运行与版本控制链路
选择并安装工具链
课程示例采用 C++17、CMake、Git 和 Visual Studio Code。Windows 推荐使用 MSYS2 的 MinGW-w64 工具链;macOS 可使用 Apple Clang;Ubuntu 可安装 GCC。不同平台的安装方式不同,但最终都要获得编译器、调试器、CMake 和 Git。
先打开终端,检查系统是否已经存在这些工具。
c++ --version
cmake --version
git --version预期输出
<COMPILER_NAME> <VERSION>
cmake version <VERSION>
git version <VERSION>实际名称和版本会因操作系统而不同;只要三个命令均返回版本且没有“command not found”,就可以继续。在 Ubuntu 24.04 上,可一次安装完整工具链。
sudo apt update
sudo apt install -y build-essential gdb cmake git预期结果
安装完成,命令退出状态为 0;软件包版本可能因镜像源更新时间不同而变化。Windows 可在 MSYS2 的 UCRT64 终端中安装对应工具;macOS 可先执行 xcode-select --install 获取 Clang,再通过 Homebrew 安装 CMake 和 Git。安装完成后,应重新执行版本检查。
配置代码编辑器
安装 Visual Studio Code 后,打开扩展面板,安装 Microsoft 提供的 C/C++ 扩展和 CMake Tools 扩展。前者负责代码补全与调试,后者负责配置、构建和运行 CMake 项目。
打开项目文件夹后,确认编辑器状态栏能够识别 CMake 工程,并选择刚安装的编译器。若编辑器找不到工具链,先在终端确认命令可用,再重启编辑器,使其重新读取环境变量。
完成编译、调试与提交验证
创建一个空目录,并添加 main.cpp 与 CMakeLists.txt。下面的程序只验证工具链,不包含引擎功能。
#include <iostream>
int main() {
// 看到这行输出,说明编译器、链接器和运行环境均可用。
std::cout << "toolchain ready" << std::endl;
return 0;
}cmake_minimum_required(VERSION 3.16)
project(Tiny2DEngine LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
add_executable(toolchain_check main.cpp)在项目目录执行配置、构建和运行。
cmake -S . -B build
cmake --build build
./build/toolchain_checkWindows 多配置生成器的可执行文件可能位于 build/Debug/toolchain_check.exe,实际路径以构建输出为准。
预期输出
toolchain ready在 return 0; 前设置断点并启动调试。程序应在断点处暂停,变量与调用栈面板可以正常打开。最后初始化 Git 仓库并提交验证程序。
git init
git add main.cpp CMakeLists.txt
git commit -m "chore: verify development toolchain"预期结果
[<BRANCH> <ID>] chore: verify development toolchain
2 files changed, <COUNT> insertions(+)分支名、提交 ID 和行数属于动态值,实际结果可能不同。提交成功说明项目已经具备最基本的版本追踪能力。
典型失败处理
出现 c++: command not found 时,说明编译器未安装或未加入环境变量。CMake 报找不到编译器时,可删除 build 目录后重新配置,避免旧缓存继续引用错误路径。断点显示为空心或调试器无法启动时,先确认 GDB 或 LLDB 命令可用,再检查编辑器选择的可执行文件。
本课总结
- 开发环境必须同时通过版本、编译、运行和调试验证
- 编辑器扩展依赖底层工具链,不能替代编译器和调试器
- Git 首次提交能够确认工程已进入可追踪状态
下一课预告
下一课将创建引擎工程骨架,划分核心模块、平台层和示例程序,为后续实现游戏循环做好结构准备。