CLion添加测试库需手动配置CMake：Google Test须用find_package(GTest REQUIRED)和target_link_libraries(your_target PRIVATE GTest::gtest GTest::gtest_main)，Catch2推荐add_subdirectory+target_link_libraries(your_target PRIVATE Catch2::Catch2)，Unity等非CMake原生库需PlatformIO显式配置test环境并添加add_test。
CLion 本身不内置测试库，添加第三方测试库的关键是：选对框架、配对 CMake、让 target_link_libraries 和 include_directories 指向正确位置。 直接在 IDE 界面点“添加库”不管用，必须手动干预构建系统。
Google Test 在 CMake 中链接失败的典型表现
编译时报 undefined reference to testing::InitGoogleTest 或找不到 GTEST_MAIN_LIBRARIES，说明链接阶段没找到符号——不是头文件没包含，而是库没连上或版本不匹配。
- 确保
find_package(GTest REQUIRED)成功执行（检查 CMake 输出里有没有Found GTest:） - 用
target_link_libraries(your_target PRIVATE GTest::gtest GTest::gtest_main)，而不是旧式gtest或gtest_main单独链接 - 如果用的是系统包安装的 libgtest-dev（如 Ubuntu），需额外调用
find_package(Threads REQUIRED)并链接Threads::Threads，否则线程相关符号缺失 - Mac 上 Homebrew 安装的
googletest默认不带 pkg-config，CMake 可能找不到；建议改用vcpkg install gtest+vcpkg integrate install，再在 CMakeLists.txt 里加set(CMAKE_TOOLCHAIN_FILE "$ENV{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake")
Clion 中使用 Catch2 时 include 路径总报错
Catch2 是 header-only 库，但 CLion 的 CMake parser 有时会忽略 include_directories() 或误判头文件位置，导致 #include <catch2/catch_test_macros.hpp> 标红但实际能编译。
- 确认
catch2头文件已放在项目内（如third_party/catch2/include），然后在 CMakeLists.txt 中写：include_directories(third_party/catch2/include) - 更推荐方式：用
add_subdirectory(third_party/catch2)（要求 catch2 目录下有 CMakeLists.txt），然后target_link_libraries(your_target PRIVATE Catch2::Catch2) - CLion 缓存可能卡住路径识别：按
File → Reload project from CMakeLists.txt，或删掉.idea/cmake-build-*目录后重新加载 - 别把
catch2/single_include/catch2/catch.hpp当作标准路径用——它不兼容现代 Catch2 v3 的模块化结构，优先用catch2/catch_test_macros.hpp
PlatformIO 项目里加 Unity 测试框架却跑不起来
Unity 不是 CMake 原生支持的测试库，PlatformIO 的 lib_deps 能拉代码，但不会自动注册测试入口或配置编译逻辑，CLion 无法识别其为可运行测试目标。
- 在
platformio.ini中明确声明测试环境：[env:test]+platform = native+framework = unity - 把测试文件放在
test/目录下，且文件名以test_开头（如test_gpio.cpp），PlatformIO 才会自动发现 - CLion 不会自动识别 PlatformIO 的 test target，需手动创建 Run Configuration：选择
PlatformIO: Test类型，指定Environment和Test directory - Unity 需要自定义
main入口，若用 PlatformIO 默认模板，它会生成UnityMain.c；但 CLion 的 CMake parser 读不到这个逻辑，所以不要指望在 CLion 内直接右键运行单个TEST_ASSERT_TRUE断言
最容易被忽略的是：CLion 的测试视图（Test 工具窗口）只响应 Google Test / Catch2 / Boost.Test 这类被 CMake 显式注册为 add_test 的目标。其他库哪怕编译通过，也不会出现在测试列表里——得靠 CMakeLists.txt 里那句 add_test(NAME xxx COMMAND xxx) 才行。
