
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(),先写:
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 就会变得自然又可靠。











