Catch2

在 Catch2 合并头文件（例如 catch_amalgamated.hpp）中，转到第 1523 行，在用于重新启用优化的 pragma 的预处理器检查中，将错误的宏 _MSVC_VER 替换为 _MSC_VER。然后重新构建你的项目。示例更正：将 #if defined(_MSVC_VER) 改为 #if defined(_MSC_VER)。此问题是在提交 45f9ea1e798c2e128dcba53602ccbddfe5676f6f 中引入的；请在有补丁版本可用时使用该版本，或保留本地头文件修复作为临时解决方案。

使用 Catch2 事件监听器，而不是将 INFO()/WARN() 与 -s 搭配使用。将诊断信息存储在全局变量或线程安全的单例中，然后仅当测试失败时，才在 testCaseEnded() 中将它们写入 stderr。CTest 的 --output-on-failure 会显示该 stderr 输出。

#include <catch2/catch_test_macros.hpp>
#include <catch2/reporters/catch_reporter_event_listener.hpp>
#include <catch2/reporters/catch_reporter_registrars.hpp>

#include <iostream>
#include <mutex>
#include <sstream>
#include <string>
#include <vector>

std::mutex g_failureInfoMutex;
std::vector<std::string> g_failureInfo;

#define FAIL_INFO(expr)                                      \
    do {                                                     \
        std::ostringstream oss;                              \
        oss << expr;                                         \
        std::lock_guard<std::mutex> lock(g_failureInfoMutex); \
        g_failureInfo.push_back(oss.str());                  \
    } while (false)

class FailureInfoListener : public Catch::EventListenerBase {
public:
    using EventListenerBase::EventListenerBase;

    void testCaseStarting(Catch::TestCaseInfo const&) override {
        std::lock_guard<std::mutex> lock(g_failureInfoMutex);
        g_failureInfo.clear();
    }

    void testCaseEnded(Catch::TestCaseStats const& stats) override {
        if (stats.totals.assertions.allOk()) {
            return;
        }

        std::cerr << "Additional failure information:\n";

        std::lock_guard<std::mutex> lock(g_failureInfoMutex);
        for (auto const& line : g_failureInfo) {
            std::cerr << line << '\n';
        }
    }
};

CATCH_REGISTER_LISTENER(FailureInfoListener)

在测试中这样使用：

TEST_CASE("GPU test") {
    FAIL_INFO("GPU: " << gpuName);
    REQUIRE(false);
}

使用以下命令运行：

ctest --output-on-failure

Catch2 没有提供从注册表中获取监听器实例的方法，因此监听器应读取共享的全局变量。如果诊断信息可能从多个线程记录，请使用互斥锁。自定义 reporter 也是一种选择，但事件监听器是更简单的推荐方案。

在 Catch2 v2.13.4 与 CMake v3.10.3 中，当通过 add_custom_command() 传递 TEST_PREFIX 时，末尾的空格会丢失。编辑你的构建所使用的 Catch.cmake（通常为 contrib/Catch.cmake，约第 160 行），并将：

-D "TEST_PREFIX=${_TEST_PREFIX}"

替换为：

-D "TEST_PREFIX='${_TEST_PREFIX}'"

等价形式为：

-D TEST_PREFIX='${_TEST_PREFIX}'

在 add_custom_command() 调用中保留 VERBATIM。重新配置并重新构建，以便测试发现脚本重新生成：

cmake -S . -B build
cmake --build build
ctest --test-dir build -N

通过此更改，TEST_PREFIX "${TARGET} " 会生成诸如 <target> <test name> 这样的 CTest 名称，而不是 <target><test name>。如果无法修补 Catch.cmake，可使用非空格分隔符（如 ${TARGET}. 或 ${TARGET}:）作为临时替代方案。

将 Catch2 升级到 v3.9.1 或更高版本，其中包含了 Clang 20 的构建修复。对于 Git 检出，运行：

git fetch --tags
git checkout v3.9.1
CXX=clang++ cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

如果你只需要 Catch2 库而不需要其自测试，可以禁用开发构建作为变通方法：

CXX=clang++ cmake -S . -B build -DCATCH_DEVELOPMENT_BUILD=OFF
cmake --build build

这些失败发生在开发/自测试目标中，因此使用 CATCH_DEVELOPMENT_BUILD=OFF 构建可避免编译那些失败的测试文件。使用 -Wno-error=unreachable-code-return 只能抑制第一个警告，并不能解决 get_wrapper 模板错误。

这是由 Clang 20/21 搭配 libc++ 导致的，而不是你的测试语法问题。Clang 会拒绝接受具有不同数量模板参数的类型列表的 TEMPLATE_PRODUCT_TEST_CASE；Clang 22 修复了该编译器问题，而 Catch2 PR #3173 添加了相应的变通方案。

修复方法是将 Catch2 从 3.15.0 升级到包含 PR #3173 的更新的 v3.x 版本，或升级到最新的 v3.x 版本。对于 Meson 子项目，请更新 subprojects/catch2.wrap 并运行：

meson subprojects update catch2
meson setup --reconfigure build

对于 CMake FetchContent，请将 GIT_TAG 更新为最新的 Catch2 v3.x 版本并重新配置。

其他变通方案：
- 将编译器升级到 Clang 22。
- 如果暂时无法升级 Catch2，可以 cherry-pick 或向后移植 catchorg/Catch2 PR #3173 中的更改。