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 的“先写需求再写实现”节奏。

立即学习“C++免费学习笔记（深入）”；

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

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

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

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

标签： git github ai c++