【C三方组件】Catch2单头文件测试框架【摘要】断言不必是手写 if、更不必是宏对槽位CHECK_EQUAL(a, b)——Catch2 说断言就该写自然表达式REQUIRE(add(2,3) 5)编译器自己当裁判。How 实测 TEST_CASE/REQUIRE/CHECK/SECTIONSECTION 让一个用例长出多条执行路径实测 3 用例跑出 7 断言、标签过滤、合并头两文件零构建。Why 拆三问自然表达式为什么更抗重构、SECTION 是怎样的展开魔术、CHECK/REQUIRE 的软硬线怎么划。测试与基准部分开篇。【版本基准】Catch2 3.16.0BSL-1.0合并头模式实测C17文中输出均为 g 13.1 实测「人话断言」的深层收益是对测试意图的保存REQUIRE(v.size() 2)读出的是断言本身大小应为二宏对断言CHECK_EQUAL(v.size(), 2)读出的是工具调用比较这两个值。差距看似微妙在断言失败的第一眼放大——REQUIRE 的失败信息直接复述意图v.size() 2展开为3 2两侧现值都在宏对的报文则是槽位视角的「expected: 2, actual: 3」槽位放反了语义跟着颠倒。调试从「意图层」出发比从「工具层」出发少一步翻译——为凌晨三点修 bug 的自己写测试是这一语法选择的全部理由。v3 的编译前提值得记Catch2 3.x 要 C14 起步、常用特性 17 更顺——存量老编译器的项目先核版本新项目无感。1. What把断言写成人话同一条断言三种写法if(add(2,3)!5){std::puts(add failed);return1;}// 手写断言淹没在流程里CHECK_EQUAL(5,add(2,3));// 宏对传统期望、实际各占一个槽REQUIRE(add(2,3)5);// Catch2自然表达式第三种没有「expected/actual 参数位」写的是普通 C 表达式——判断逻辑就是被测逻辑本身。这是 Catch2Phil Nash最深入人心的创新它的另一半卖点是两个文件就是全部catch_amalgamated.hpp/.cpp零构建接入。两种形态的编译账合并头首次全编约十几秒、之后增量秒级库模式首次配置几分钟、之后链接毫秒级——按仓库的「改测试频率」选。2. 项目接入// vcpkgvcpkg.json{dependencies:[catch2]}最原始的路拷catch_amalgamated.hppcatch_amalgamated.cpp两个文件进工程——本篇实测即此模式编译两个文件就有一个完整测试框架v3 也有正规的 CMake 库模式大项目用那个。SECTION 的执行模型用「旅程」比喻再压实一遍这是理解 Catch2 的关键框架把 TEST_CASE 体当一张地图每个 SECTION 是地图上的一条岔路——框架开车从起点出发 N 趟每趟只拐进一条岔路。共用代码是「每趟都会经过的主干道」。与传统夹具fixture对照夹具是「每用例一间更衣室」SECTION 是「每次出发重走一遍出发点」——前者隔离状态后者重放路径语义微妙不同写出来的测试味道也不同SECTION 更适合「同一段流程的多种走向」。3. 核心概念用例、节、软硬断言概念写法语义用例TEST_CASE(名, [标签])名字是句子标签是目录节SECTION(分支)从用例开头重放的一条分支路径硬断言REQUIRE(expr)失败即终止本用例软断言CHECK(expr)失败继续收集全部问题SECTION 是 Catch2 的独门同一个 TEST_CASE 里的多个 SECTION每个都会从用例开头重新执行一遍只走进自己的分支——用一套准备代码喂多条路径§5 ② 详解。标签体系再展开一层实测 [math] 过滤通过标签可组合、可取反——[math],[container]任一命中、[~container]排除、[.integration]默认隐藏、显式点名才跑——慢测试的标准归宿。标签是测试的「运维元数据CI 分层快集全跑、慢集夜跑、本地开发排除重型——全部靠命令行标签表达式完成不动代码。Catch2 的命令行家族补全实测 [math] 之外为文档级--list-tests列清单、--success成功也显示写测试时确认「真的在跑」、--break首个失败进调试器断下、--durations按耗时排序慢测试猎手、--order rand随机打乱用例序暴露用例间的隐藏依赖。命令行即测试管理入口过滤复现靠标签、慢测试狩猎靠 durations、依赖暴露靠随机序——本地与 CI 共用同一套词汇复现全程不动代码。4. How四件套实测#includecatch_amalgamated.hppintadd(inta,intb){returnab;}TEST_CASE(add works,[math]){REQUIRE(add(2,3)5);REQUIRE(add(-1,1)0);}TEST_CASE(vector grows,[container]){std::vectorintv;// 共用准备代码SECTION(push_back){v.push_back(1);v.push_back(2);REQUIRE(v.size()2);}SECTION(empty then push){REQUIRE(v.empty());v.push_back(9);REQUIRE(v.size()1);}}TEST_CASE(strings match,[text]){autosstd::string(hi cli);REQUIRE(shi cli);CHECK(s.size()6);}实测运行与标签过滤$ tool All tests passed (7 assertions in 3 test cases) $ tool [math] All tests passed (2 assertions in 1 test case)注意第一行3 个 test case 跑出 7 条断言——「vector grows」的两个 SECTION 各执行了一次含共用代码这就是「节」的展开。BDD 别名是 Catch2 的隐藏彩蛋文档级SCENARIO/GIVEN/WHEN/THEN四个宏是 TEST_CASE/SECTION 的同义词——写出来就是需求文档的样子场景-前提-操作-结果。同一个 SECTION 机制、两副笔墨技术视角用 TEST_CASE/SECTION、业务视角用 SCENARIO 四件套——后者在「测试要给产品经理看」的团队里是沟通利器。v3 的「合并头 vs CMake 库」双形态值得一个历史注脚v2 时代只有单头编译慢是公认痛点v3 重构成模块化库、合并头作为兼容层保留——「单头是营销库化是工程」Catch2 用一个大版本承认了这件事。选型时按第 6 节的编译成本权衡别被「单头」的便利幻觉拖进全量重编的泥潭。SECTION 的一图流总结一张地图 N 趟车程主干道每趟重走、岔路每趟一条——「重放路径」而非「隔离状态」。5. Why三个追问① 自然表达式为什么更抗重构REQUIRE(v.size() 2)里没有参数位——比较方向、相等/不等全由你写宏对断言CHECK_EQUAL(期望, 实际)则约定了两个槽位放反了报文就颠倒。更微妙的是重构安全性REQUIRE(x y)改成REQUIRE(x ! y)是一处平凡编辑宏对体系里「EQUAL 改 NOT_EQUAL」要换宏名——工具链如 clang-tidy对自然表达式的理解也远好于宏展开。代价自然表达式想报出「两侧值」得靠表达式分解decomposition——把两侧拆开各自求值再拼回报文模板元编程层层递归比宏直接展开两个实参黑得多失败报文里v.size() 2展开为3 2的两侧现值即其产物。② SECTION 是怎样的展开魔术直觉模型每个 SECTION 是一次「从用例起点出发的独立旅程」。框架把 TEST_CASE 的函数体跑 N 遍N SECTION 数第 k 遍只激活第 k 个节——共用代码构造 v每遍重跑节与节之间零状态泄漏。这等价于「把准备代码写在用例体内、每节自动套一件新衣」不用为共享准备单写夹具类用例里的本地变量天然就是各节的脚手架。嵌套 SECTION 就是旅程里再分岔路径数 叶节数组合爆炸要节制。③ CHECK/REQUIRE 的软硬线怎么划语义REQUIRE 失败即终止本用例后续代码在错误前提下没意义CHECK 失败继续收集全部问题一次看全。实用划线后续语句依赖该断言结果时用 REQUIRE——解引用前查空指针必须硬断言继续就是段错误比对多个独立输出用 CHECK一次看全。Catch2 的特别处在软断言的作用域因 SECTION 的存在「继续」的范围是「本旅程」节与节天然隔离——软断言的失败不会污染下一条路径。合并头的编译成本要有体感catch_amalgamated.cpp全量编译一次约十几秒本篇实测机器——每轮全量重编测试二进制会累积成显著等待。中大型项目的姿势是把它编成独立静态库编译一次、链接 N 次或直接上 v3 的 CMake 库模式——「单头方便」与「增量编译」的取舍在工程规模放大后反转。一条速记REQUIRE 是「这条路径的判决」、CHECK 是「这条路径的证词收集」——判决终结审理、证词允许继续作证。6. 坑与最佳实践实测依据SECTION 会重复执行共用代码重准备建库、起进程别放在 TEST_CASE 体里用每遍成本低的准备重家伙上TEST_CASE_METHOD夹具套件级共享另说。REQUIRE 的 return 语义REQUIRE 靠return实现提前退出——非 void 辅助函数里直接编译不过。断言语法再自然也救不了宏的实现机制。断言别放进被测代码路径的关键循环REQUIRE 的表达式分解有字符串开销发布构建无关测试构建的极端热路径注意。浮点比较用ApproxREQUIRE(x Approx(0.3))——直接对浮点几乎总是错。命令行即过滤器[math]标签、vector grows名字、[math],[container]交并——CI 里失败最小化复现的利器实测标签过滤可用。matcher 体系补一笔文档级REQUIRE_THAT(v, Catch::Matchers::WithinAbs(0.3, 1e-6))这类「约束对象」写法是浮点与容器断言的正统出口VectorContains、Contains等——自然表达式管标量比较matcher 管模糊匹配与容器语义。浮点这个硬问题上 Catch2 给了两条路轻量路是上文坑 4 的Approx重量路是 matcher——表达式管精确、约束对象管语义分工清楚。决策速记零构建接入与表达力优先 Catch2、编译速度敏感选 doctest——后者是「Catch 语法 更快编译」的追随者迁移成本只是命令行参数的肌肉记忆。7. 选型对比Catch2 与 doctestCatch2doctest形态合并头两文件v3 另有 CMake 库模式单头一个断言自然表达式同 Catch 风格独有武器SECTION、BDD 别名、matcher编译速度最快生态大中经验法则doctest 自称「保留了 Catch 表达力的最快框架」——语法同宗分界在编译账与功能面测试高频改动的大仓库doctest 的增量编译优势会累积成体感要 SECTION、matcher、BDD 别名这套全家桶就上 Catch2v3 库模式下两家的编译差距也在缩小。先上手哪个都不亏。收官一句Catch2 把「断言写成人话」推到了语法层面的极限——自然表达式、SECTION、标签三位一体教的是测试的表达力而无论日后换到哪个框架「隔离、最小复现、意图清晰」的测试思维都是同一套全部可迁移。8. 延伸与联动官方 github.com/catchorg/Catch2——tutorial 与 assertions 两章覆盖日常九成doctest 是「Catch 语法 更快编译」的追随者思路同源不再单开一篇本部分收官篇 Google Benchmark从「对不对」到「有多快」。〔关联 第 23 篇〕参考catchorg/Catch2 3.16.0BSL-1.0。7 断言/3 用例、SECTION 展开、标签过滤均为本机实测g 13.1合并头模式。