
为C++项目写单元测试,Catch2 是最轻量、易上手且社区活跃的选择——不用写头文件声明、不依赖构建系统、单头文件开箱即用。
快速开始:三步跑通第一个测试
Catch2 只需一个头文件就能运行。把 catch2/catch_test_macros.hpp 包进来,写个 TEST_CASE 就能编译执行:
- 下载或通过 vcpkg/conan 安装 Catch2(推荐 vcpkg install catch2)
- 新建 tests/main.cpp,包含头文件并写一个测试用例
- 用普通 C++ 编译器编译(如 g++ -std=c++17 main.cpp -o tests)并运行
示例代码片段:
#define CATCH_CONFIG_MAIN
#include "catch2/catch_test_macros.hpp"
TEST_CASE("加法运算正确", "[math]") {
REQUIRE(2 + 2 == 4);
REQUIRE(0 + (-1) == -1);
}
组织测试:用 SECTION 和 SCENARIO 拆分逻辑场景
单个 TEST_CASE 内可用 SECTION 划分不同输入分支,避免重复 setup;更语义化的 SCENARIO + WHEN/THEN 适合行为驱动风格:
立即学习“C++免费学习笔记(深入)”;
- SECTION 在同一作用域内隔离变量和断言,失败时只报该段
- SCENARIO 自动按字符串分组,配合 GIVEN/WHEN/THEN 提升可读性
- 所有 SECTION 共享 TEST_CASE 的前置代码,无需手动重复初始化
比如测试 vector push_back 的边界行为,一个 TEST_CASE 里用多个 SECTION 覆盖空、满、扩容三种情况,比拆成三个 TEST_CASE 更紧凑。
断言与检查:REQUIRE、CHECK 和 WARN 的区别
Catch2 提供三级检查强度,选错会影响调试效率:
- REQUIRE:失败立即终止当前测试用例(适合前置条件,如指针非空、文件打开成功)
- CHECK:失败记录但继续执行(适合校验多个返回值或循环中逐项验证)
- WARN:仅打印警告,不计入失败统计(用于临时标记待优化的边界情况)
别在 CHECK 后面跟可能崩溃的操作(比如解引用空指针),否则 CHECK 失败后程序仍可能 crash。
集成到项目:CMake 中添加测试目标
用 CMake 管理项目时,建议将测试作为独立 target,方便 CI 运行:
- 用 find_package(Catch2 REQUIRED) 找到 Catch2(安装后自动注册)
- add_executable() 创建测试可执行文件,target_link_libraries() 链接 Catch2::Catch2
- 用 include(CTest) + add_test() 注册,之后可直接 cmake --build . --target test
不需要额外写 main() —— Catch2 的 CATCH_CONFIG_MAIN 宏已提供入口点,只要确保它只在一个源文件中定义即可。
基本上就这些。Catch2 不追求功能堆砌,而是让写测试这件事本身不成为负担。从第一个 REQUIRE 开始,逐步覆盖核心函数、边界输入和错误路径,比追求 100% 行覆盖率更有实际价值。










