如何为C++项目编写单元测试？Catch2测试框架使用指南【软件测试】

为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 适合行为驱动风格：

• 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% 行覆盖率更有实际价值。