CLion C++单元测试入门教程-C++-PHP中文网

clion需显式集成gtest等框架并正确配置cmakelists.txt才能识别测试；必须通过add_executable生成可执行目标、链接gtest::gtest_main、调用gtest_discover_tests，且目标名不能含空格。

clion c++单元测试入门教程

CLion 对 C++ 单元测试的支持不是“开箱即用”的完整环境，而是依赖你显式集成测试框架（如 gtest、catch2）并正确配置 CMakeLists.txt。不配好构建系统，IDE 就识别不出测试，右键菜单里不会出现 “Run Test”，Ctrl+Shift+R 也无效。

为什么 CLion 找不到你的测试函数？

常见现象：写了 TEST(TestCase, SubTest) { ASSERT_EQ(1, 1); }，但左侧装订区没运行图标，右键没有 “Run ‘TEST…’” 选项。

最直接原因：CMakeLists.txt 没把测试源文件编译成可执行目标，或没链接 gtest 库
CLion 不会自动扫描代码里的宏；它只解析 CMake 构建图中被标记为测试目标的可执行文件（例如通过 add_executable(tests ...) + target_link_libraries(tests gtest)）
如果你用的是 add_library() 编译测试逻辑，但没生成可执行文件，CLion 就无法启动它——测试必须是能独立运行的二进制
检查 CMake 构建日志：是否报错 Unknown CMake command "gtest_discover_tests"？说明 find_package(GTest REQUIRED) 失败，或 gtest 根本没安装/没被 CMake 找到

快速验证 gtest 是否真正可用

别急着写业务测试，先跑通一个最小闭环：

C++

"空空如也"

下载

确保已安装 gtest：Linux/macOS 用 sudo apt install libgtest-dev 或 brew install googletest；Windows 推荐用 vcpkg install gtest

在项目根目录新建 test/main_test.cpp，内容仅含：

#include <gtest>
TEST(Dummy, AlwaysPasses) { EXPECT_TRUE(true); }
int main(int argc, char **argv) {
  ::testing::InitGoogleTest(&argc, argv);
  return RUN_ALL_TESTS();
}</gtest>

修改 CMakeLists.txt，追加：

find_package(GTest REQUIRED)
add_executable(unit_tests test/main_test.cpp)
target_link_libraries(unit_tests GTest::gtest_main)

点击右上角 “Reload CMake project”，然后在 unit_tests 可执行目标旁点击 ▶ 运行——若看到 [==========] Running 1 test...，说明环境通了

CMakeLists.txt 中最容易漏掉的三处

即使 gtest 安装正确，以下配置缺失仍会导致测试不被识别：

target_compile_features(unit_tests PRIVATE cxx_std_17)：C++17 是现代 gtest（尤其是 1.12+）的底线要求，缺了可能编译失败或链接异常
没调用 gtest_discover_tests(unit_tests)：这行才是让 CLion 在测试视图中列出所有 TEST 的关键；它必须放在 add_executable 和 target_link_libraries 之后
测试目标名不能含空格或特殊字符：比如 add_executable(my tests ...) 会让 CMake 解析失败，CLion 同步构建图时直接跳过该目标

真正卡住人的从来不是语法，而是 CMake 构建目标和 IDE 测试发现机制之间的那一层映射关系——它不透明、不报具体错误，只表现为“图标消失”或“右键无响应”。每次怀疑测试失效，优先重载 CMake、检查构建日志里有没有 gtest_discover_tests 成功注册的痕迹，比反复改测试代码更有效。

C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！