游戏客户端架构 / 系统课时

准备开发工具

准备开发工具

本课将搭建二维引擎开发所需的基础工具链,并通过版本、编译和调试检查确认环境可用。完成后,你会得到一个能够编译 C++、启动调试会话并提交 Git 版本的最小开发环境。

学习目标

  • 安装并确认 C++ 编译器与调试器可用
  • 配置代码编辑器和常用扩展
  • 用最小程序验证编译、运行与版本控制链路

选择并安装工具链

课程示例采用 C++17、CMake、Git 和 Visual Studio Code。Windows 推荐使用 MSYS2 的 MinGW-w64 工具链;macOS 可使用 Apple Clang;Ubuntu 可安装 GCC。不同平台的安装方式不同,但最终都要获得编译器、调试器、CMake 和 Git。

先打开终端,检查系统是否已经存在这些工具。

bash
c++ --version
cmake --version
git --version

预期输出

text
<COMPILER_NAME> <VERSION>
cmake version <VERSION>
git version <VERSION>

实际名称和版本会因操作系统而不同;只要三个命令均返回版本且没有“command not found”,就可以继续。在 Ubuntu 24.04 上,可一次安装完整工具链。

bash
sudo apt update
sudo apt install -y build-essential gdb cmake git

预期结果

text
安装完成,命令退出状态为 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。下面的程序只验证工具链,不包含引擎功能。

cpp
#include <iostream>

int main() {
    // 看到这行输出,说明编译器、链接器和运行环境均可用。
    std::cout << "toolchain ready" << std::endl;
    return 0;
}
cmake
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)

在项目目录执行配置、构建和运行。

bash
cmake -S . -B build
cmake --build build
./build/toolchain_check

Windows 多配置生成器的可执行文件可能位于 build/Debug/toolchain_check.exe,实际路径以构建输出为准。

预期输出

text
toolchain ready

在 return 0; 前设置断点并启动调试。程序应在断点处暂停,变量与调用栈面板可以正常打开。最后初始化 Git 仓库并提交验证程序。

bash
git init
git add main.cpp CMakeLists.txt
git commit -m "chore: verify development toolchain"

预期结果

text
[<BRANCH> <ID>] chore: verify development toolchain
 2 files changed, <COUNT> insertions(+)

分支名、提交 ID 和行数属于动态值,实际结果可能不同。提交成功说明项目已经具备最基本的版本追踪能力。

典型失败处理

出现 c++: command not found 时,说明编译器未安装或未加入环境变量。CMake 报找不到编译器时,可删除 build 目录后重新配置,避免旧缓存继续引用错误路径。断点显示为空心或调试器无法启动时,先确认 GDB 或 LLDB 命令可用,再检查编辑器选择的可执行文件。

本课总结

  • 开发环境必须同时通过版本、编译、运行和调试验证
  • 编辑器扩展依赖底层工具链,不能替代编译器和调试器
  • Git 首次提交能够确认工程已进入可追踪状态

下一课预告

下一课将创建引擎工程骨架,划分核心模块、平台层和示例程序,为后续实现游戏循环做好结构准备。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

准备开发工具

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通