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

编写基础测试

编写基础测试

本课为引擎中最容易被改坏的纯逻辑模块建立一组可重复运行的测试,覆盖二维向量、资源路径规范化、简单序列化和圆形碰撞,并用统一的通过与失败输出形成最小测试基线。

学习目标

  • 为确定性函数设计正常、边界和反例测试
  • 编写一个无需第三方框架的最小 C++ 测试程序
  • 通过退出码和测试输出接入日常构建验证

选择最先测试的模块

基础测试应优先覆盖输入确定、输出明确、运行快速的代码。数学运算适合验证数值结果,资源路径适合验证规范化规则,序列化适合验证往返一致性,碰撞算法适合验证接触边界和明显分离。

渲染画面、声音设备和操作系统窗口依赖外部环境,不适合作为第一批单元测试。它们可以稍后使用集成测试或人工验收覆盖,避免基础测试因机器差异频繁失败。

编写最小测试程序

下面是一个可直接编译的完整示例。check 负责统计结果;每组测试只验证一个行为,失败时给出可定位的名称。浮点数比较使用误差范围,而不是直接使用 ==。

cpp
#include <cmath>
#include <iostream>
#include <sstream>
#include <stdexcept>
#include <string>

struct Vec2 {
    double x;
    double y;

    double length() const {
        return std::sqrt(x * x + y * y);
    }
};

std::string normalizePath(std::string path) {
    for (char& ch : path) {
        if (ch == '\\') {
            ch = '/';
        }
    }
    while (path.find("//") != std::string::npos) {
        path.replace(path.find("//"), 2, "/");
    }
    if (path.rfind("./", 0) == 0) {
        path.erase(0, 2);
    }
    return path;
}

std::string serializeVec2(const Vec2& value) {
    std::ostringstream out;
    out << value.x << ',' << value.y;
    return out.str();
}

Vec2 deserializeVec2(const std::string& text) {
    std::istringstream in(text);
    Vec2 value{};
    char comma = 0;
    in >> value.x >> comma >> value.y;
    if (!in || comma != ',') {
        throw std::runtime_error("invalid Vec2");
    }
    return value;
}

bool circlesOverlap(const Vec2& a, double ar, const Vec2& b, double br) {
    const double dx = a.x - b.x;
    const double dy = a.y - b.y;
    const double radius = ar + br;
    return dx * dx + dy * dy <= radius * radius;
}

int main() {
    int passed = 0;
    int failed = 0;

    auto check = [&](bool condition, const std::string& name) {
        if (condition) {
            ++passed;
            std::cout << "[PASS] " << name << '\n';
        } else {
            ++failed;
            std::cout << "[FAIL] " << name << '\n';
        }
    };

    check(std::abs(Vec2{3.0, 4.0}.length() - 5.0) < 1e-9,
          "Vec2 length");
    check(normalizePath(".\\assets//hero.png") == "assets/hero.png",
          "resource path normalization");

    const Vec2 original{1.5, -2.0};
    const Vec2 restored = deserializeVec2(serializeVec2(original));
    check(std::abs(restored.x - original.x) < 1e-9 &&
              std::abs(restored.y - original.y) < 1e-9,
          "Vec2 serialization round trip");

    check(circlesOverlap({0.0, 0.0}, 1.0, {2.0, 0.0}, 1.0),
          "circles touching");
    check(!circlesOverlap({0.0, 0.0}, 1.0, {2.1, 0.0}, 1.0),
          "circles separated");

    std::cout << "passed=" << passed << " failed=" << failed << '\n';
    return failed == 0 ? 0 : 1;
}

保存为 basic_tests.cpp 后编译并运行:

bash
g++ -std=c++17 -O2 basic_tests.cpp -o basic_tests
./basic_tests

预期输出:

text
[PASS] Vec2 length
[PASS] resource path normalization
[PASS] Vec2 serialization round trip
[PASS] circles touching
[PASS] circles separated
passed=5 failed=0

程序在全部通过时返回退出码 0,任一测试失败时返回 1。构建脚本或持续集成系统可以据此阻止有回归的版本继续发布。

让测试覆盖边界而不是实现细节

一个函数通常至少需要正常输入、边界输入和反例。圆形碰撞的边界是两圆刚好相切,因此示例同时测试距离等于半径和、大于半径和两种情况。若只测试明显重叠,< 与 <= 的错误就不会被发现。

测试应描述公开行为,不要依赖内部变量、循环次数或私有容器布局。实现从平方根距离改为平方距离后,只要输入输出规则不变,测试无需修改,这样测试才能保护重构而不是阻碍重构。

序列化测试采用“对象转文本再还原”的往返验证,但还应逐步补充非法文本、缺失字段和版本变化。资源路径测试也应增加空路径、绝对路径和 .. 是否允许等项目规则。

组织与运行策略

测试文件应与生产代码分开编译,但复用同一份头文件和实现。命名建议使用“模块_场景_预期结果”,失败时可以直接看出哪个行为被破坏。每次修改数学、资源或碰撞代码后先运行相关测试,提交前再运行全部基础测试。

不要让基础测试依赖网络、真实时间、随机种子或本机文件目录。确实需要这些依赖时,应注入可替换接口或提供固定测试数据,保证同一提交在不同机器上得到相同结果。

常见错误:只验证“没有崩溃”、把多个行为塞进一个测试、使用精确浮点比较,以及失败后仍返回退出码 0,都会降低自动化测试的可信度。

本课总结

  • 第一批测试应覆盖确定、快速且容易回归的纯逻辑模块
  • 测试要包含边界与反例,并验证公开行为而不是内部实现
  • 统一输出和非零失败退出码,才能让测试真正进入构建流程

下一课预告

下一课将把计时数据与测试结果纳入更完整的调试流程,形成从发现问题、复现、修复到防止回归的闭环。

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

目录与阅读设置

阅读设置

17

记录一个想法

编写基础测试

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

登录哪都通