1. 什么是 Catch2 Matchers？为什么需要它？

Catch2（C++ Automated Test Cases in Headers）是一个现代化的 C++ 单元测试框架，以单个头文件的形式分发。其最强大的特性之一就是 Matchers（匹配器） 系统——一种声明式的值检查工具，能让测试代码更易读、更灵活、信息更丰富。

与传统的断言（如 REQUIRE(x == 5)）不同，匹配器允许你用接近自然语言的方式表达复杂的检查条件。例如，要检查向量中所有元素是否都大于 0，无需编写循环，只需一行代码：REQUIRE_THAT(vec, Catch::Matchers::AllMatch(Catch::Matchers::Predicate<int>([](int i) { return i > 0; })))。这不仅精简了代码，更让测试意图一目了然。

为什么需要匹配器？首先，它们提供了极高的表达力：你可以用简洁的语法检查字符串是否包含子串、是否以特定前缀开头，或数字是否在指定范围内。其次，匹配器在测试失败时能给出详细的诊断信息——不再是干巴巴的 "false"，而是有意义的提示，例如："Expected: starts with 'Hello' Actual: 'World'"。最后，匹配器是可组合的：你可以通过逻辑运算符（And、Or、Not）将简单匹配器组合成复杂的检查表达式。

2. 安装指南

Catch2 是一个纯头文件库（header-only），无需复杂的安装或构建配置。以下是两种主流安装方式：

方式一：下载单个文件（推荐新手）

从 Catch2 官方 GitHub 发布页 下载 catch_amalgamated.hpp 或 catch.hpp 文件。将其放入项目目录，然后在代码中引入：

#include "catch_amalgamated.hpp"

方式二：使用包管理器（vcpkg、Conan、CMake FetchContent）

对于专业项目，推荐使用包管理器。以 vcpkg 为例：

# 通过 vcpkg 安装 Catch2
vcpkg install catch2

然后在 CMakeLists.txt 中配置：

find_package(Catch2 REQUIRED)
target_link_libraries(my_test PRIVATE Catch2::Catch2WithMain)

注意： Catch2 v3.x 及以上版本中，匹配器位于 Catch::Matchers 命名空间。v2.x 版本同样使用 Catch::Matchers，但头文件结构有所不同。对于 v3.x，请使用 #include <catch2/catch_test_macros.hpp> 和 #include <catch2/matchers/catch_matchers_all.hpp>。

3. 快速上手——最小可运行示例

下面是一个使用匹配器检查字符串的简单测试：

// test.cpp
#define CATCH_CONFIG_MAIN  // 该宏只能出现在一个 .cpp 文件中
#include <catch2/catch_test_macros.hpp>
#include <catch2/matchers/catch_matchers_all.hpp>
#include <string>

TEST_CASE("字符串匹配器测试", "[string]") {
    std::string hello = "Hello, World!";

    // 检查字符串是否包含子串
    CHECK_THAT(hello, Catch::Matchers::ContainsSubstring("World"));

    // 检查字符串是否以 "Hello" 开头
    CHECK_THAT(hello, Catch::Matchers::StartsWith("Hello"));

    // 检查字符串是否以 "!" 结尾
    CHECK_THAT(hello, Catch::Matchers::EndsWith("!"));
}