c++ Catch2测试框架入门指南_c++ BDD风格单元测试【TDD】

Catch2 是 C++ 中轻量、易上手、支持 BDD（行为驱动开发）风格的现代测试框架，无需额外编译、头文件即用，非常适合 TDD（测试驱动开发）实践。它语法简洁，断言直观，还能自然表达“应该怎样”的业务意图。

快速开始：三步跑起第一个测试

只需一个头文件，就能写测试、运行测试：

• 下载 catch2.hpp（推荐从 GitHub Releases 获取最新版），或用 vcpkg/conan 安装
• 新建 tests.cpp，包含头文件并写一个最简测试用例：

#define CATCH_CONFIG_MAIN
#include "catch2.hpp"

TEST_CASE("加法运算正确", "[math]") {
    REQUIRE(2 + 2 == 4);
    REQUIRE(1 + 0 == 1);
}

• 编译运行：g++ -std=c++17 tests.cpp -o tests && ./tests，看到绿色 PASS 就成功了

BDD 风格：用 GIVEN-WHEN-THEN 组织可读性测试

Catch2 原生支持 BDD 关键字（GIVEN、WHEN、THEN），让测试像自然语言一样描述行为：

SCENARIO("用户登录流程") {
    GIVEN("一个已注册的用户") {
        User user("alice", "pass123");
        
        WHEN("输入正确密码并提交") {
            bool result = user.login("pass123");
            
            THEN("应登录成功") {
                REQUIRE(result == true);
            }
            THEN("用户名应被记录") {
                REQUIRE(user.last_login_name() == "alice");
            }
        }

        WHEN("输入错误密码") {
            bool result = user.login("wrong");
            
            THEN("应登录失败") {
                REQUIRE(result == false);
            }
        }
    }
}

这种结构清晰体现“场景—前提—动作—预期”，方便协作与维护，也天然契合 TDD 的“先写需求再写实现”节奏。

TDD 实战小技巧：从失败测试出发

写测试时，别急着让代码通过——先确认它真的会失败（红灯），才是 TDD 正确起点：

• 写一个新 TEST_CASE 或 SCENARIO，调用尚未实现的函数或类
• 编译若报错（如 undefined reference），说明接口还没定义 → 先补声明（头文件）
• 运行测试，看到 FAILED → 说明测试有效，可以动手实现最小逻辑
• 实现后再次运行，看到 PASSED → 提交、重构、继续下一个测试

例如，想实现 String::trim()，先写：

TEST_CASE("trim 去除首尾空格") {
    REQUIRE(String("  hello  ").trim() == "hello");
}

此时编译不过或运行失败都正常——这正是你下一步工作的明确信号。

常用断言与调试提示

Catch2 断言自带上下文输出，出错时自动打印表达式和值，省去手动 log：

• REQUIRE(expr)：失败立即中止当前用例（推荐用于关键前提）
• CHECK(expr)：失败继续执行（适合检查多个独立条件）
• REQUIRE_THROWS_AS(expr, ExceptionType)：验证异常类型
• INFO("msg") + 断言：在失败信息前追加自定义上下文

例如：

INFO("Testing with input: " << input);
REQUIRE(parser.parse(input).size() == expected_count);

运行失败时，会清楚显示 input 值和期望数量，大幅缩短调试时间。

基本上就这些。Catch2 不复杂但容易忽略的是：它不强制项目结构，但建议把测试按模块拆分（如 test_math.cpp、test_network.cpp），统一用 CATCH_CONFIG_MAIN 只在一个文件定义主入口，其余只 include 头文件即可。坚持写短小、单一、BDD 风格的测试，TDD 就会变得自然又可靠。