直接 #include "doctest.h" 即可，需确保文件在编译器 include 路径中；推荐放项目根目录或 test/ 下并用 -i. 或 -itest/ 指定，禁用 尖括号写法。
doctest 头文件怎么引入才不报错
直接 #include "doctest.h" 就行，但必须确保这个头文件在编译器能找到的路径里。常见错误是下载了 doctest 单头文件却没加到 include 路径，或者用 #include <doctest.h></doctest.h>（尖括号会去系统路径找，基本找不到）。
推荐做法：把 doctest.h 放进项目根目录或 test/ 子目录，然后用双引号包含，并在编译时通过 -I. 或 -Itest/ 告诉编译器位置。
- 别用 CMake 的
find_package(doctest)—— doctest 没提供官方 CMake config，强行用容易链接失败 - 如果和 main 冲突（比如你已有自己的
main()），得在某个 cpp 文件里定义DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN宏再包含头文件，否则链接时报multiple definition of 'main' - Mac 上用 Clang 编译时，若报
error: unknown argument: '-fno-rtti'，说明你项目开了 RTTI 但 doctest 默认关了——加-DDOCTEST_CONFIG_NO_RTTI=1或干脆关掉这个宏定义更省事
写一个最简测试用例要注意什么
doctest 的测试块本质是普通 C++ 函数调用，靠宏展开成注册逻辑。最简可用写法就是：
#define DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
#include "doctest.h"
TEST_CASE("addition works") {
CHECK(2 + 2 == 4);
CHECK_FALSE(3 > 5);
}
这里几个关键点：
-
TEST_CASE是必须的外层容器，不能裸写CHECK；漏了会编译通过但测试根本不运行 -
CHECK是轻量断言，失败只报错不停止；要中断执行用REQUIRE（比如检查指针非空后再解引用） - 不要在
TEST_CASE外写断言——语法上合法但不会被发现，doctest 完全忽略 - 函数名字符串里别用斜杠或控制字符，某些终端会解析异常；空格和下划线安全
如何让 doctest 只跑部分测试
靠命令行参数过滤，不是改代码。编译出可执行文件后，直接传参就能筛：
-
./test --help查所有选项，核心是--filter -
./test --filter "[add]"匹配所有含 “add” 的 TEST_CASE 名 -
./test --filter "math*" --filter "-*slow"表示跑 math 开头但排除 slow 结尾的测试 - 注意 shell 通配符会被提前展开，所以一定要加引号，否则
*slow可能被 shell 当前目录文件名替换 - CI 环境中常配合
--abort-after（失败 N 个就停）和--no-skip（忽略[.][!]标签）来控节奏
为什么 CHECK 断言失败却不打印变量值
doctest 默认只输出原始表达式（如 CHECK(a == b) 失败时显示 a == b is false），不会自动展开 a 和 b 的值。这不是 bug，是设计取舍：避免隐式流操作开销和依赖 operator。
想看到具体值，有三个办法：
- 手动补日志：
CHECK(a == b) && (doctest::detail::StringMaker<int>::convert(a) + " != " + doctest::detail::StringMaker<int>::convert(b))</int></int>—— 太重，不推荐 - 用
INFO宏提前打值：INFO("a=" - 升级到 doctest 2.4.9+，启用
DOCTEST_CONFIG_SUPER_FAST_ASSERTS=0（默认已开），它会让CHECK自动尝试调用operator —— 但前提是你的类型真实现了它
自定义类型没重载 时，INFO 是最稳的方案；别指望 doctest 替你猜怎么格式化。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
