不能直接在测试目录用add_subdirectory引入测试工程，因为测试依赖主工程已定义的target、头文件路径和链接库；若执行顺序错乱或重复project()，将导致target未定义、头文件找不到或链接失败。
为什么不能直接在测试目录里用 add_subdirectory 引入测试工程
因为 CMake 的 add_subdirectory 本质是“嵌套执行另一个 CMakeLists.txt”，而测试工程通常依赖主工程的头文件、编译定义甚至链接库——如果测试目录的 CMakeLists.txt 没提前知道这些信息，find_package 会失败，target_include_directories 会找不到路径，target_link_libraries 会报 target not found。
常见错误现象：CMake Error: target "mylib" is not defined 或 fatal error: mylib/myheader.h: No such file or directory。
- 主工程必须先通过
add_library(mylib ...)定义目标，且该目标作用域需对子目录可见（默认是的） - 测试子目录的
CMakeLists.txt必须在主工程 target 创建之后才被add_subdirectory执行 - 不要在测试目录里重复
project()；CMake 不允许嵌套 project
正确结构：主工程中定义库，再用 add_subdirectory 加载测试
推荐目录结构：
myproject/
├── CMakeLists.txt # 主 CMakeLists，定义 mylib + add_subdirectory(tests)
├── src/
│ └── mylib.cpp
├── include/mylib/myheader.h
└── tests/
├── CMakeLists.txt # 只定义 test executable + link mylib
└── test_main.cpp
主 CMakeLists.txt 关键顺序不能错：
- 调用
project()和set(CMAKE_CXX_STANDARD 17)等基础设置 - 用
add_library(mylib ...)构建接口库（建议INTERFACE或STATIC，避免测试时重编译） - 用
target_include_directories(mylib PUBLIC $暴露头文件$ -
最后 写
add_subdirectory(tests)
测试子目录的 CMakeLists.txt 怎么写才不报错
它不能独立运行，只负责声明测试可执行文件并消费主工程产出。核心是：不重新找依赖，只用已定义的 target。
示例 tests/CMakeLists.txt：
if(CMAKE_PROJECT_NAME STREQUAL PROJECT_NAME) find_package(GTest REQUIRED) endif() <p>add_executable(test_mylib test_main.cpp) target_link_libraries(test_mylib PRIVATE mylib GTest::gtest_main)</p><h1>注意：mylib 是主 CMakeLists 中定义的 target 名，不是路径或变量名</h1><p>enable_testing() add_test(NAME mylib_unit_tests COMMAND test_mylib)</p>
-
if(CMAKE_PROJECT_NAME STREQUAL PROJECT_NAME)是防御性写法：防止 tests 被单独cmake调用时崩溃 -
target_link_libraries(... PRIVATE mylib)中的mylib必须和主工程中add_library(mylib ...)的名字完全一致（大小写敏感） - 不要在 tests 里写
include_directories(../include)——mylib的PUBLIC包含路径已自动传递
为什么 add_subdirectory 加测试比 add_test 更灵活
add_test 只能注册已存在的可执行文件，而 add_subdirectory 让你把测试组织成完整子工程：支持多测试文件、自定义构建选项、条件编译（如 if(BUILD_TESTS)）、甚至集成 Catch2 或 doctest 的宏注册机制。
但代价是耦合变强：测试代码和主工程共享同一个 CMake configure 阶段，修改测试 CMakeLists 可能触发整个工程重配置。容易被忽略的一点是：add_subdirectory 的路径是相对于当前 CMakeLists.txt 的，写成 add_subdirectory(tests/) 和 add_subdirectory(tests) 效果一样，但写成 add_subdirectory(../tests) 就会破坏作用域隔离，导致 target 查找失败。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
