Catch2 版本演进全景从 v1.x 到 v3.x 的发布记录深度解析【免费下载链接】Catch2A modern, C-native, test framework for unit-tests, TDD and BDD - using C14, C17 and later (C11 support is in v2.x branch, and C03 on the Catch1.x branch)项目地址: https://gitcode.com/GitHub_Trending/ca/Catch2Catch2 是一个现代、C 原生的测试框架支持单元测试、TDD 与 BDD采用 C14/C17 及更新标准C11 支持在 v2.x 分支C03 在 Catch1.x 分支。本文以仓库内的 docs/release-notes.md 为主体系统梳理 Catch2 从 v1.6.0 到 v3.15.2 的完整演进脉络并对每个大版本的关键特性做源码级剖析。读完本文你将理解 Catch2 为何从单头文件分发转向静态库分发、生成器Generators与匹配器Matchers如何一步步成熟、线程安全支持如何转正以及如何利用这份发布记录制定自己的升级与迁移决策。一、发布记录文档的定位与用法release-notes.md是 Catch2 官方文档体系docs/Readme.md中的版本编年史成员。文档顶部按版本倒序提供了完整的目录索引从 3.15.2 一直回溯到 2.0.1再到 v1.x 的Older versions段每个版本条目统一按Fixes / Improvements / Miscellaneous部分大版本含 Breaking changes、FAQ、Internal changes 等三类组织。这份文档的实用价值在于升级决策每次升级前对照相邻版本条目核对破坏性变更与行为变化特性考古确认某个宏、命令行选项、CMake 选项从哪个版本引入、哪个版本转正或废弃迁移参照v3.0.1 条目内置了迁移 FAQ 与迁移文档入口是 v2 → v3 的第一手资料。二、v3.x 时代现代 Catch2 的稳定与深化2.1 3.15.xconstexpr 匹配器与编译期断言v3.15.0 是当前发布记录中功能增量最鲜明的一版新增STATIC_REQUIRE_THAT在编译期对匹配器进行断言前提是编译器对匹配器提供足够的constexpr支持泛型new-style匹配器支持 C20 的 constexpr 匹配但组合匹配器Combining matchers需要 C26Catch2 自带的所有泛型匹配器均已开启 constexpr修复了 C26 下std::optionalT变成 range 后与StringMaker偏特化的歧义冲突#3095。源码佐证在 src/catch2/catch_test_macros.hpp 中CATCH_STATIC_REQUIRE/CATCH_STATIC_CHECK在默认路径下直接展开为static_assert并附带一条CATCH_SUCCEED记录而当定义了CATCH_CONFIG_RUNTIME_STATIC_REQUIRE时则退化为运行期断言CATCH_REQUIRE/CATCH_CHECK。这印证了发布记录中编译期 vs 运行期双模式的设计。v3.15.2 则修复了--warn InfiniteGenerators在通过路径过滤限定生成器元素时被误触发的问题以及-fnoexceptions构建下的-Wunused-parameter告警同时catch_discover_tests可以容忍二进制因全局构造器打印非 Catch2 输出#3162。2.2 3.14.x兼容性修补与 UTF-8 感知换行JUnit 报告器现在对每个测试用例只输出单条失败error/skipped断言#1919修复CATCH_CONFIG_PREFIX_ALL下主库构建失败#3087与catch_discover_tests在PRE_TEST发现阶段目标无可发现测试时的崩溃#3075行包裹line-wrapping按 UTF-8 码点而非字节计数#1022, #3086组合字符序列仍会误计Catch2 并不追求完整 Unicode 支持--list-tags与--list-listeners的默认实现新增 quiet 变体。2.3 3.13.x生成器Generators能力大爆发v3.13.0 是生成器子系统的一次集中增强对应源码实现位于 src/catch2/generators/新增ConcatGenerator短名cat把多个独立生成器拼接为一个实现在 src/catch2/generators/catch_generators_adapters.hpp生成器可高效跳转到第 n 个元素自定义生成器通过重写skipToNthElementImpl获得该能力基类默认实现位于 src/catch2/generators/catch_generators.hpp生成器可声明自身为无限基类出于向后兼容默认声明为有限自定义生成器应重写isFinite()返回正确值catch_generators.hpp新增--warn InfiniteGenerators当GENERATE被赋予无限生成器时报错。该警告的 CLI 解析在 src/catch2/internal/catch_commandline.cpp运行期判定在 src/catch2/internal/catch_run_context.cpp扩展了 CLI 的 section 过滤能力可指定测试用例中要使用的生成器元素MapGenerator仅在输出会被使用时才调用映射函数避免无谓开销修复--benchmark-samples 0硬崩溃#3056改为 CLI 校验失败。2.4 3.12.x线程安全断言转正v3.12.0 最重要的事件是线程安全支持不再处于实验阶段其 CMake 选项与 C 宏统一为CATCH_CONFIG_THREAD_SAFE_ASSERTIONS。同时修复多过滤条件时 section 过滤的怪异行为#3038修复进程启动早期使用消息宏的线程安全问题为多处代码添加lifetimebound属性支持生命周期分析的编译器将能诊断匹配器组合器的非法使用全局变量仅在线程安全构建中被标记为thread_local#3044。2.5 3.11.x断言性能提升与 Bazel 集成断言性能最高提升约 10%Release 模式的断言快速路径收益最大新增对 BazelTEST_RANDOM_SEED#3021与TEST_PREMATURE_EXIT_FILE#3020环境变量的支持后者通过 CLI 暴露为--premature-exit-guard-file——若测试进程异常死亡该文件会留存修复消息宏在特定并发场景下的竞态#3031Catch2 的 SEH 过滤器在报告错误后会继续调用先前安装的过滤器#3033。2.6 3.10.x线程安全消息宏与转义提速INFO、CAPTURE、WARN、SUCCEED等消息宏变为线程安全无需转义的字符串在 XML/JSON 输出时吞吐提升约 3 倍长字符串最高可达 10 倍filter改为按值存储谓词#3002, #3005避免在GENERATE_COPY/GENERATE_REF内使用时的悬垂风险pkg-config 文件在选择安装目标时会考虑DESTDIR环境变量#3006, #3019。2.7 3.9.x默认随机顺序与线程安全断言实验v3.9.0 包含多个影响深远的行为变化默认测试运行顺序改为随机新增实验性线程安全断言支持opt-in当报告器不请求 passing 断言的assertionEnded事件时Console/Compact 报告器即默认行为通过断言的性能显著提升简单REQUIRE(true)在 Release 下快 60%、Debug 下快 80%REQUIRE_NOTHROW快 230%/430%REQUIRE_THROWS因抛异常本身的开销仅快约 3%/20%退出码常量成为 Session API 的一部分#2955, #2976FAIL与SKIP宏之后标记为不可达unreachable让编译器理解宏后不会继续执行从而消除告警scoped 消息的生命周期现在严格遵循其作用域#1759, #2019, #2959不再为意外异常保留上下文新增assertionStarting事件的快速路径默认 opt-in报告器通过ReporterPreferences::shouldReportAllAssertionStarts启用。v3.9.1 修复了嵌套断言的多层错误报告#1292与枚举位域断言的分解#3001并保证表达式字符串化过程中抛出的异常不再导致断言失败#2980。2.8 3.8.xcatch_discover_tests重写catch_discover_tests的测试发现逻辑改为解析 JSON 报告器输出因此现在要求 CMake 3.19 或更新版本新增ADD_TAGS_AS_LABELS选项可为每个 CTest 测试打上对应的 Catch2 测试标签修复无TEST_CASE时catch_discover_tests失败的问题#2962构建 Catch2 所需的最低 CMake 版本提升至 3.16Bazel 构建迁移到 BzlmodMeson 构建新增不安装 Catch2的选项。2.9 3.7.x持久化 Fixture 与 JUnit 报告器巨幅提速新增TEST_CASE_PERSISTENT_FIXTURE#2885, #1602与TEST_CASE_METHOD不同该宏在同一测试用例的所有 partial run 之间复用同一个底层实例JUnit 报告器对成功断言的处理性能大幅提升#28971 个测试用例、1000 万条断言时新实现快 3 倍且仅用约 8 MB 内存旧实现需要 7 GB重构输出重定向组合 stdout 报告器与捕获式报告器时后者不再看到前者的全部输出基于文件的重定向不再为每次 partial run 打开新的临时文件标准化各类失败的退出码不运行任何测试且未传--allow-running-no-tests时退出码为 2全部跳过为 4断言失败恒为 42见 v3.7.1。2.10 3.6.x ~ 3.5.x浮点精度与随机可复现性浮点 StringMaker 的precision默认取max_digits10v3.6.0保证任意两个 float 都能通过输出区分列包裹在计算宽度时忽略 ANSI 颜色码#2833, #2849random生成器对整型与 float/double 跨平台可复现v3.5.0与random不同Catch2 生成器还支持 1 字节整型char、bool等该保证仅适用于 IEEE 754 浮点平台long double因跨平台差异过大不在保证之列新增CATCH_CONFIG_PREFIX_MESSAGES只给INFO/UNSCOPED_INFO/WARN/CAPTURE加前缀CATCH_CONFIG_DEFAULT_REPORTER现在可以是任意报告器 spec而不仅是普通报告器名v3.5.4可内联编译自定义参数v3.5.4 重新支持 GCC 5/6v3.5.3 恢复 VS2017 兼容并明确一旦再出问题将再次放弃支持。2.11 3.4.x ~ 3.1.x静态分析、SA 支持与平台扩张实验性静态分析支持v3.4.0TEST_CASE与SECTION宏在 SA 工具自动检测 clang-tidy 与 Coverity视角下被重新定义帮助工具推理含 section 的路径由CATCH_CONFIG_EXPERIMENTAL_STATIC_ANALYSIS_SUPPORT控制XML 报告器为INFO/WARN增加位置信息XML 格式版本升至 3v3.4.0支持断言只可与字面量 0 比较的类型如 C20 的std::*_orderingv3.2.0——这需要对分解层decomposition做重大重写新增Catch::getSeedv3.1.1catch_all.hpp便捷头不再传递包含windows.hv3.1.1shared library 设置SOVERSION支持 Bazel 的BAZEL_TEST环境变量与更多 sharding 变量v3.2.0--skip-benchmarks标志v3.0.1编译平台覆盖 PlayStation、QNX、XBox、UWP、VxWorks、Cygwin、IAR 等。2.12 3.0.1v3 里程碑——静态库分发时代v3.0.1 是整个 v3 系列的奠基版本发布记录特别说明了Catch2 改用静态编译库作为分发模型FAQ 要点为何拆分头文件单头文件分发与提供多样实用特性天然冲突新增一个 Matcher 会让所有用户付出编译开销却只惠及少数人是否回归单头文件不会但提供sqlite 风格的 amalgamated 分发即 extras/catch_amalgamated.cpp 与 extras/catch_amalgamated.hpp仓库现成可查catch_all.hpp便捷头存在的原因之一是快速迁移但包含它会有显著的编译时间负担应当是有意识地选择。主要破坏性变更节选#include catch.hpp不再可用需链接静态库并包含多个头文件最低语言版本提升到C14ANON_TEST_CASE被移除--list-test-names-only被移除改用--list-tests的详细度修饰符--list*命令不再返回非零退出码且输出走报告器管道XmlReporter 输出机器可解析的 XMLTEST_CASE描述支持被移除隐藏测试用例[.]不再因不匹配排除标签而被包含匹配器命名空间重做公开匹配器功能统一置于Catch::Matchers命名空间定义CATCH_CONFIG_MAIN不再在该 TU 生成 main需链接libCatch2Main.a或对应 CMake/pkg-config targetCATCH_CONFIG_IMPL、CATCH_CONFIG_EXTERNAL_INTERFACES被移除GENERATE对其参数做 decay字符串字面量推断为const char*--colour改为--colour-mode-l/-t短选项被移除新增--list-listeners、--skip-benchmarks、--rng-seed random-device支持测试 sharding、多报告器同时输出到不同文件-r接受可选输出目标、-o -/--out-表示 stdout。性能对照表v3 vs v2同任务下 v3 的加速比任务Debug 构建Release 构建运行 100 万次REQUIRE(true)1.10 ± 0.011.02 ± 0.06运行 100 个测试、3^3 sections、每个 1 条 REQUIRE1.27 ± 0.011.04 ± 0.01运行 3000 个测试、无名字无标签1.29 ± 0.011.05 ± 0.01运行 3000 个测试、有名字有标签1.49 ± 0.011.22 ± 0.01从 3000 个测试中运行 1 个、无名字无标签1.68 ± 0.021.19 ± 0.22从 3000 个测试中运行 1 个、有名字有标签1.79 ± 0.022.06 ± 0.23发布记录同时提供了专门的 迁移指南是 v2 用户升级的第一入口。三、v2.x 时代Catch2 的成长曲线v2 系列2.0.1 → 2.13.7见证了大量今天核心特性的诞生3.1 测试模板化与类型参数化2.5.0 ~ 2.8.02.5.0 引入TEMPLATE_TEST_CASE2.6.0 引入TEMPLATE_PRODUCT_TEST_CASE2.8.0 引入支持 NTTP 的模板测试宏与REGISTER_ENUM2.9.0 模板测试支持类型列表2.13.x 简化模板测试实现TEMPLATE_LIST_TEST_CASE支持不可拷贝/不可移动类型2.10.0。3.2 生成器体系成熟2.6.0 ~ 2.13.02.4.0 引入实验性数据生成器2.6.0 声明生成器功能完全支持接口重做并支持 Input 生成器2.7.0 新增random生成器、UNSCOPED_INFO、RangeGenerator、ChunkGenerator2.10.0 新增from_range生成器2.13.0 允许GENERATE跟随同层SECTION。3.3 匹配器家族扩张2.1.0 新增Matches字符串正则、UnorderedEquals向量集合相等、WithinAbs/WithinULP浮点2.10.0 新增异常消息匹配器Message与相对相等匹配器WithinRel比较时两侧都参与误差计算并特判 NaN/INFINITY2.12.x 向量匹配器支持自定义分配器与初始化列表。3.4 命令行与运行控制2.13.0 新增-D/--min-duration超过时长的测试打印名字与耗时2.11.2 新增--benchmark-warmup-time2.11.2--wait-for-keypress接受never2.12.0 重做随机顺序--order rand同一种子下所有平台顺序一致且只选子集不改变相对顺序。3.5 构建与集成2.13.4 废弃ParseAndAddCatchTests推荐基于运行期信息的catch_discover_tests2.13.2 的catch_discover_tests支持自定义报告器、输出位置与WORKING_DIRECTORY2.0.1 增加 pkg-config 安装支持2.1.2 开始以 CMake 包/可链接目标形式导出。3.6 v2 时代的奠基性重写2.0.1移除 C98 支持与旧式报告器/生成器Catch::toString被StringMaker特化优先、operator其次的新机制取代新增*_THROWS_MATCHES引入 Clara CLI 解析库报告器/监听器可获得致命错误通知CATCH_CONFIG_DISABLE实验实现受 Doctest 启发。四、v1.x 时代回顾经典的沉淀发布记录在 Older versions 段保留了对 v1.6.0 ~ v1.12.2 的摘要值得注意的历史节点1.6.x 起统一 CMake 工程结构、支持 Linux 调试断点、Approx支持/1.7.x 通过断言快速路径大幅降低开销内部微基准从约 3.4s 降至约 0.7s支持按 section 运行与 Windows SEH1.8.x 引入FAIL_CHECK、TAP 与 Automake 报告器、CATCH_CONFIG_FAST_COMPILE、Approx的绝对误差 margin、CAPTURE断言式字符串化1.9.x 增加--list-extra-info、--wait-for-keypressApprox成员函数在 C11 模式接受强 typedef1.11.x 修复REQUIRE_FALSE的表达式重建括号问题Approx::Margin变为包含边界1.12.x 完善 XML 报告器与INFO输出、min/max标识符防御 Windows 宏。文档明确指出v1.6.0 之前未维护发布记录可查阅 Git 历史。五、从发布记录看 Catch2 的工程方法论综观三个大版本发布记录清晰折射出几条贯穿始终的工程原则性能与编译期开销是头等议题从 v1.7 的运行时优化到 v2.3 的ReporterPreferences::shouldReportAllAssertions再到 v3.9 的 passing 断言快速路径、v3.15 的成功断言再快 1-2%每条性能结论都附带可量化的对照数据可复现性优先v3.5 的跨平台随机生成器复现、v2.12 的跨平台随机顺序直接服务于 CI 调试破坏性变更有说明书v3.0.1 用独立章节 FAQ 迁移文档承载全部破坏性变更v2.2.3 等版本也明确标注patch 版本也可能是 breaking废弃有节奏ParseAndAddCatchTests2.13.4 废弃、线程安全实验3.9 实验 → 3.12 转正、skipTest事件3.3.0 废弃都能在发布记录中找到时间线工程兼容面持续外扩从 MSVC/GCC/Clang 三件套逐步覆盖 PlayStation、QNX、XBox、UWP、VxWorks、Cygwin、IAR、Green Hills、DJGPP、Emscripten 等平台并持续与 Bazel、Meson、Conan、pkg-config、CTest 生态对齐。六、如何使用这份发布记录配套文档导航发布记录中的许多条目指向更详细的专项文档结合仓库可形成完整的学习路径断言与浮点比较docs/assertions.md、docs/comparing-floating-point-numbers.md匹配器docs/matchers.md生成器与 section 过滤docs/generators.md、docs/filtering-execution-path.md报告器与事件docs/reporters.md、docs/reporter-events.md命令行与编译期配置docs/command-line.md、docs/configuration.mdCMake 集成docs/cmake-integration.md线程安全与限制docs/thread-safety.md、docs/limitations.md弃用与迁移docs/deprecations.md、docs/migrate-v2-to-v3.md。此外catch_discover_tests的实现在 extras/CatchAddTests.cmake 与 extras/CatchShardTests.cmake生成器与匹配器的当前实现分别位于 src/catch2/generators/ 与 src/catch2/matchers/测试用例则在 tests/SelfTest/UsageTests/ 下如 Generators.tests.cpp、Matchers.tests.cpp、Benchmark.tests.cpp可作为阅读发布记录时的对照源码。总结而言docs/release-notes.md 不仅是一份变更清单更是 Catch2 设计决策与平台兼容策略的浓缩历史。无论是评估升级风险、确认特性引入版本还是理解某个宏背后的设计动机它都是仓库中最值得反复查阅的文档之一。【免费下载链接】Catch2A modern, C-native, test framework for unit-tests, TDD and BDD - using C14, C17 and later (C11 support is in v2.x branch, and C03 on the Catch1.x branch)项目地址: https://gitcode.com/GitHub_Trending/ca/Catch2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Catch2 版本演进全景：从 v1.x 到 v3.x 的发布记录深度解析
Catch2 版本演进全景从 v1.x 到 v3.x 的发布记录深度解析【免费下载链接】Catch2A modern, C-native, test framework for unit-tests, TDD and BDD - using C14, C17 and later (C11 support is in v2.x branch, and C03 on the Catch1.x branch)项目地址: https://gitcode.com/GitHub_Trending/ca/Catch2Catch2 是一个现代、C 原生的测试框架支持单元测试、TDD 与 BDD采用 C14/C17 及更新标准C11 支持在 v2.x 分支C03 在 Catch1.x 分支。本文以仓库内的 docs/release-notes.md 为主体系统梳理 Catch2 从 v1.6.0 到 v3.15.2 的完整演进脉络并对每个大版本的关键特性做源码级剖析。读完本文你将理解 Catch2 为何从单头文件分发转向静态库分发、生成器Generators与匹配器Matchers如何一步步成熟、线程安全支持如何转正以及如何利用这份发布记录制定自己的升级与迁移决策。一、发布记录文档的定位与用法release-notes.md是 Catch2 官方文档体系docs/Readme.md中的版本编年史成员。文档顶部按版本倒序提供了完整的目录索引从 3.15.2 一直回溯到 2.0.1再到 v1.x 的Older versions段每个版本条目统一按Fixes / Improvements / Miscellaneous部分大版本含 Breaking changes、FAQ、Internal changes 等三类组织。这份文档的实用价值在于升级决策每次升级前对照相邻版本条目核对破坏性变更与行为变化特性考古确认某个宏、命令行选项、CMake 选项从哪个版本引入、哪个版本转正或废弃迁移参照v3.0.1 条目内置了迁移 FAQ 与迁移文档入口是 v2 → v3 的第一手资料。二、v3.x 时代现代 Catch2 的稳定与深化2.1 3.15.xconstexpr 匹配器与编译期断言v3.15.0 是当前发布记录中功能增量最鲜明的一版新增STATIC_REQUIRE_THAT在编译期对匹配器进行断言前提是编译器对匹配器提供足够的constexpr支持泛型new-style匹配器支持 C20 的 constexpr 匹配但组合匹配器Combining matchers需要 C26Catch2 自带的所有泛型匹配器均已开启 constexpr修复了 C26 下std::optionalT变成 range 后与StringMaker偏特化的歧义冲突#3095。源码佐证在 src/catch2/catch_test_macros.hpp 中CATCH_STATIC_REQUIRE/CATCH_STATIC_CHECK在默认路径下直接展开为static_assert并附带一条CATCH_SUCCEED记录而当定义了CATCH_CONFIG_RUNTIME_STATIC_REQUIRE时则退化为运行期断言CATCH_REQUIRE/CATCH_CHECK。这印证了发布记录中编译期 vs 运行期双模式的设计。v3.15.2 则修复了--warn InfiniteGenerators在通过路径过滤限定生成器元素时被误触发的问题以及-fnoexceptions构建下的-Wunused-parameter告警同时catch_discover_tests可以容忍二进制因全局构造器打印非 Catch2 输出#3162。2.2 3.14.x兼容性修补与 UTF-8 感知换行JUnit 报告器现在对每个测试用例只输出单条失败error/skipped断言#1919修复CATCH_CONFIG_PREFIX_ALL下主库构建失败#3087与catch_discover_tests在PRE_TEST发现阶段目标无可发现测试时的崩溃#3075行包裹line-wrapping按 UTF-8 码点而非字节计数#1022, #3086组合字符序列仍会误计Catch2 并不追求完整 Unicode 支持--list-tags与--list-listeners的默认实现新增 quiet 变体。2.3 3.13.x生成器Generators能力大爆发v3.13.0 是生成器子系统的一次集中增强对应源码实现位于 src/catch2/generators/新增ConcatGenerator短名cat把多个独立生成器拼接为一个实现在 src/catch2/generators/catch_generators_adapters.hpp生成器可高效跳转到第 n 个元素自定义生成器通过重写skipToNthElementImpl获得该能力基类默认实现位于 src/catch2/generators/catch_generators.hpp生成器可声明自身为无限基类出于向后兼容默认声明为有限自定义生成器应重写isFinite()返回正确值catch_generators.hpp新增--warn InfiniteGenerators当GENERATE被赋予无限生成器时报错。该警告的 CLI 解析在 src/catch2/internal/catch_commandline.cpp运行期判定在 src/catch2/internal/catch_run_context.cpp扩展了 CLI 的 section 过滤能力可指定测试用例中要使用的生成器元素MapGenerator仅在输出会被使用时才调用映射函数避免无谓开销修复--benchmark-samples 0硬崩溃#3056改为 CLI 校验失败。2.4 3.12.x线程安全断言转正v3.12.0 最重要的事件是线程安全支持不再处于实验阶段其 CMake 选项与 C 宏统一为CATCH_CONFIG_THREAD_SAFE_ASSERTIONS。同时修复多过滤条件时 section 过滤的怪异行为#3038修复进程启动早期使用消息宏的线程安全问题为多处代码添加lifetimebound属性支持生命周期分析的编译器将能诊断匹配器组合器的非法使用全局变量仅在线程安全构建中被标记为thread_local#3044。2.5 3.11.x断言性能提升与 Bazel 集成断言性能最高提升约 10%Release 模式的断言快速路径收益最大新增对 BazelTEST_RANDOM_SEED#3021与TEST_PREMATURE_EXIT_FILE#3020环境变量的支持后者通过 CLI 暴露为--premature-exit-guard-file——若测试进程异常死亡该文件会留存修复消息宏在特定并发场景下的竞态#3031Catch2 的 SEH 过滤器在报告错误后会继续调用先前安装的过滤器#3033。2.6 3.10.x线程安全消息宏与转义提速INFO、CAPTURE、WARN、SUCCEED等消息宏变为线程安全无需转义的字符串在 XML/JSON 输出时吞吐提升约 3 倍长字符串最高可达 10 倍filter改为按值存储谓词#3002, #3005避免在GENERATE_COPY/GENERATE_REF内使用时的悬垂风险pkg-config 文件在选择安装目标时会考虑DESTDIR环境变量#3006, #3019。2.7 3.9.x默认随机顺序与线程安全断言实验v3.9.0 包含多个影响深远的行为变化默认测试运行顺序改为随机新增实验性线程安全断言支持opt-in当报告器不请求 passing 断言的assertionEnded事件时Console/Compact 报告器即默认行为通过断言的性能显著提升简单REQUIRE(true)在 Release 下快 60%、Debug 下快 80%REQUIRE_NOTHROW快 230%/430%REQUIRE_THROWS因抛异常本身的开销仅快约 3%/20%退出码常量成为 Session API 的一部分#2955, #2976FAIL与SKIP宏之后标记为不可达unreachable让编译器理解宏后不会继续执行从而消除告警scoped 消息的生命周期现在严格遵循其作用域#1759, #2019, #2959不再为意外异常保留上下文新增assertionStarting事件的快速路径默认 opt-in报告器通过ReporterPreferences::shouldReportAllAssertionStarts启用。v3.9.1 修复了嵌套断言的多层错误报告#1292与枚举位域断言的分解#3001并保证表达式字符串化过程中抛出的异常不再导致断言失败#2980。2.8 3.8.xcatch_discover_tests重写catch_discover_tests的测试发现逻辑改为解析 JSON 报告器输出因此现在要求 CMake 3.19 或更新版本新增ADD_TAGS_AS_LABELS选项可为每个 CTest 测试打上对应的 Catch2 测试标签修复无TEST_CASE时catch_discover_tests失败的问题#2962构建 Catch2 所需的最低 CMake 版本提升至 3.16Bazel 构建迁移到 BzlmodMeson 构建新增不安装 Catch2的选项。2.9 3.7.x持久化 Fixture 与 JUnit 报告器巨幅提速新增TEST_CASE_PERSISTENT_FIXTURE#2885, #1602与TEST_CASE_METHOD不同该宏在同一测试用例的所有 partial run 之间复用同一个底层实例JUnit 报告器对成功断言的处理性能大幅提升#28971 个测试用例、1000 万条断言时新实现快 3 倍且仅用约 8 MB 内存旧实现需要 7 GB重构输出重定向组合 stdout 报告器与捕获式报告器时后者不再看到前者的全部输出基于文件的重定向不再为每次 partial run 打开新的临时文件标准化各类失败的退出码不运行任何测试且未传--allow-running-no-tests时退出码为 2全部跳过为 4断言失败恒为 42见 v3.7.1。2.10 3.6.x ~ 3.5.x浮点精度与随机可复现性浮点 StringMaker 的precision默认取max_digits10v3.6.0保证任意两个 float 都能通过输出区分列包裹在计算宽度时忽略 ANSI 颜色码#2833, #2849random生成器对整型与 float/double 跨平台可复现v3.5.0与random不同Catch2 生成器还支持 1 字节整型char、bool等该保证仅适用于 IEEE 754 浮点平台long double因跨平台差异过大不在保证之列新增CATCH_CONFIG_PREFIX_MESSAGES只给INFO/UNSCOPED_INFO/WARN/CAPTURE加前缀CATCH_CONFIG_DEFAULT_REPORTER现在可以是任意报告器 spec而不仅是普通报告器名v3.5.4可内联编译自定义参数v3.5.4 重新支持 GCC 5/6v3.5.3 恢复 VS2017 兼容并明确一旦再出问题将再次放弃支持。2.11 3.4.x ~ 3.1.x静态分析、SA 支持与平台扩张实验性静态分析支持v3.4.0TEST_CASE与SECTION宏在 SA 工具自动检测 clang-tidy 与 Coverity视角下被重新定义帮助工具推理含 section 的路径由CATCH_CONFIG_EXPERIMENTAL_STATIC_ANALYSIS_SUPPORT控制XML 报告器为INFO/WARN增加位置信息XML 格式版本升至 3v3.4.0支持断言只可与字面量 0 比较的类型如 C20 的std::*_orderingv3.2.0——这需要对分解层decomposition做重大重写新增Catch::getSeedv3.1.1catch_all.hpp便捷头不再传递包含windows.hv3.1.1shared library 设置SOVERSION支持 Bazel 的BAZEL_TEST环境变量与更多 sharding 变量v3.2.0--skip-benchmarks标志v3.0.1编译平台覆盖 PlayStation、QNX、XBox、UWP、VxWorks、Cygwin、IAR 等。2.12 3.0.1v3 里程碑——静态库分发时代v3.0.1 是整个 v3 系列的奠基版本发布记录特别说明了Catch2 改用静态编译库作为分发模型FAQ 要点为何拆分头文件单头文件分发与提供多样实用特性天然冲突新增一个 Matcher 会让所有用户付出编译开销却只惠及少数人是否回归单头文件不会但提供sqlite 风格的 amalgamated 分发即 extras/catch_amalgamated.cpp 与 extras/catch_amalgamated.hpp仓库现成可查catch_all.hpp便捷头存在的原因之一是快速迁移但包含它会有显著的编译时间负担应当是有意识地选择。主要破坏性变更节选#include catch.hpp不再可用需链接静态库并包含多个头文件最低语言版本提升到C14ANON_TEST_CASE被移除--list-test-names-only被移除改用--list-tests的详细度修饰符--list*命令不再返回非零退出码且输出走报告器管道XmlReporter 输出机器可解析的 XMLTEST_CASE描述支持被移除隐藏测试用例[.]不再因不匹配排除标签而被包含匹配器命名空间重做公开匹配器功能统一置于Catch::Matchers命名空间定义CATCH_CONFIG_MAIN不再在该 TU 生成 main需链接libCatch2Main.a或对应 CMake/pkg-config targetCATCH_CONFIG_IMPL、CATCH_CONFIG_EXTERNAL_INTERFACES被移除GENERATE对其参数做 decay字符串字面量推断为const char*--colour改为--colour-mode-l/-t短选项被移除新增--list-listeners、--skip-benchmarks、--rng-seed random-device支持测试 sharding、多报告器同时输出到不同文件-r接受可选输出目标、-o -/--out-表示 stdout。性能对照表v3 vs v2同任务下 v3 的加速比任务Debug 构建Release 构建运行 100 万次REQUIRE(true)1.10 ± 0.011.02 ± 0.06运行 100 个测试、3^3 sections、每个 1 条 REQUIRE1.27 ± 0.011.04 ± 0.01运行 3000 个测试、无名字无标签1.29 ± 0.011.05 ± 0.01运行 3000 个测试、有名字有标签1.49 ± 0.011.22 ± 0.01从 3000 个测试中运行 1 个、无名字无标签1.68 ± 0.021.19 ± 0.22从 3000 个测试中运行 1 个、有名字有标签1.79 ± 0.022.06 ± 0.23发布记录同时提供了专门的 迁移指南是 v2 用户升级的第一入口。三、v2.x 时代Catch2 的成长曲线v2 系列2.0.1 → 2.13.7见证了大量今天核心特性的诞生3.1 测试模板化与类型参数化2.5.0 ~ 2.8.02.5.0 引入TEMPLATE_TEST_CASE2.6.0 引入TEMPLATE_PRODUCT_TEST_CASE2.8.0 引入支持 NTTP 的模板测试宏与REGISTER_ENUM2.9.0 模板测试支持类型列表2.13.x 简化模板测试实现TEMPLATE_LIST_TEST_CASE支持不可拷贝/不可移动类型2.10.0。3.2 生成器体系成熟2.6.0 ~ 2.13.02.4.0 引入实验性数据生成器2.6.0 声明生成器功能完全支持接口重做并支持 Input 生成器2.7.0 新增random生成器、UNSCOPED_INFO、RangeGenerator、ChunkGenerator2.10.0 新增from_range生成器2.13.0 允许GENERATE跟随同层SECTION。3.3 匹配器家族扩张2.1.0 新增Matches字符串正则、UnorderedEquals向量集合相等、WithinAbs/WithinULP浮点2.10.0 新增异常消息匹配器Message与相对相等匹配器WithinRel比较时两侧都参与误差计算并特判 NaN/INFINITY2.12.x 向量匹配器支持自定义分配器与初始化列表。3.4 命令行与运行控制2.13.0 新增-D/--min-duration超过时长的测试打印名字与耗时2.11.2 新增--benchmark-warmup-time2.11.2--wait-for-keypress接受never2.12.0 重做随机顺序--order rand同一种子下所有平台顺序一致且只选子集不改变相对顺序。3.5 构建与集成2.13.4 废弃ParseAndAddCatchTests推荐基于运行期信息的catch_discover_tests2.13.2 的catch_discover_tests支持自定义报告器、输出位置与WORKING_DIRECTORY2.0.1 增加 pkg-config 安装支持2.1.2 开始以 CMake 包/可链接目标形式导出。3.6 v2 时代的奠基性重写2.0.1移除 C98 支持与旧式报告器/生成器Catch::toString被StringMaker特化优先、operator其次的新机制取代新增*_THROWS_MATCHES引入 Clara CLI 解析库报告器/监听器可获得致命错误通知CATCH_CONFIG_DISABLE实验实现受 Doctest 启发。四、v1.x 时代回顾经典的沉淀发布记录在 Older versions 段保留了对 v1.6.0 ~ v1.12.2 的摘要值得注意的历史节点1.6.x 起统一 CMake 工程结构、支持 Linux 调试断点、Approx支持/1.7.x 通过断言快速路径大幅降低开销内部微基准从约 3.4s 降至约 0.7s支持按 section 运行与 Windows SEH1.8.x 引入FAIL_CHECK、TAP 与 Automake 报告器、CATCH_CONFIG_FAST_COMPILE、Approx的绝对误差 margin、CAPTURE断言式字符串化1.9.x 增加--list-extra-info、--wait-for-keypressApprox成员函数在 C11 模式接受强 typedef1.11.x 修复REQUIRE_FALSE的表达式重建括号问题Approx::Margin变为包含边界1.12.x 完善 XML 报告器与INFO输出、min/max标识符防御 Windows 宏。文档明确指出v1.6.0 之前未维护发布记录可查阅 Git 历史。五、从发布记录看 Catch2 的工程方法论综观三个大版本发布记录清晰折射出几条贯穿始终的工程原则性能与编译期开销是头等议题从 v1.7 的运行时优化到 v2.3 的ReporterPreferences::shouldReportAllAssertions再到 v3.9 的 passing 断言快速路径、v3.15 的成功断言再快 1-2%每条性能结论都附带可量化的对照数据可复现性优先v3.5 的跨平台随机生成器复现、v2.12 的跨平台随机顺序直接服务于 CI 调试破坏性变更有说明书v3.0.1 用独立章节 FAQ 迁移文档承载全部破坏性变更v2.2.3 等版本也明确标注patch 版本也可能是 breaking废弃有节奏ParseAndAddCatchTests2.13.4 废弃、线程安全实验3.9 实验 → 3.12 转正、skipTest事件3.3.0 废弃都能在发布记录中找到时间线工程兼容面持续外扩从 MSVC/GCC/Clang 三件套逐步覆盖 PlayStation、QNX、XBox、UWP、VxWorks、Cygwin、IAR、Green Hills、DJGPP、Emscripten 等平台并持续与 Bazel、Meson、Conan、pkg-config、CTest 生态对齐。六、如何使用这份发布记录配套文档导航发布记录中的许多条目指向更详细的专项文档结合仓库可形成完整的学习路径断言与浮点比较docs/assertions.md、docs/comparing-floating-point-numbers.md匹配器docs/matchers.md生成器与 section 过滤docs/generators.md、docs/filtering-execution-path.md报告器与事件docs/reporters.md、docs/reporter-events.md命令行与编译期配置docs/command-line.md、docs/configuration.mdCMake 集成docs/cmake-integration.md线程安全与限制docs/thread-safety.md、docs/limitations.md弃用与迁移docs/deprecations.md、docs/migrate-v2-to-v3.md。此外catch_discover_tests的实现在 extras/CatchAddTests.cmake 与 extras/CatchShardTests.cmake生成器与匹配器的当前实现分别位于 src/catch2/generators/ 与 src/catch2/matchers/测试用例则在 tests/SelfTest/UsageTests/ 下如 Generators.tests.cpp、Matchers.tests.cpp、Benchmark.tests.cpp可作为阅读发布记录时的对照源码。总结而言docs/release-notes.md 不仅是一份变更清单更是 Catch2 设计决策与平台兼容策略的浓缩历史。无论是评估升级风险、确认特性引入版本还是理解某个宏背后的设计动机它都是仓库中最值得反复查阅的文档之一。【免费下载链接】Catch2A modern, C-native, test framework for unit-tests, TDD and BDD - using C14, C17 and later (C11 support is in v2.x branch, and C03 on the Catch1.x branch)项目地址: https://gitcode.com/GitHub_Trending/ca/Catch2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考