CLion 本身不直接测试项目模块，而是通过集成测试框架（如 Catch2、Google Test 等）运行用户编写的测试代码来验证模块功能；关键在于确保测试源码已加入构建系统（如 CMakeLists.txt）、测试目标正确定义并链接对应模块、且 CLion 成功检测到该测试目标。
CLion 本身不直接“测试项目模块”，它通过集成测试框架（如 Google Test、Catch2、Boost.Test、Doctest、Vitest、Mocha、Karma、CTest）来运行你写好的测试代码——而这些测试代码，才是你用来验证项目中某个模块（比如一个类、一组函数、一个头文件封装的逻辑）是否符合预期的真正手段。
怎么让 CLion 识别并运行你的模块测试
关键不是“选中模块右键测试”，而是确保：
- 你的测试源码已加入 CMakeLists.txt（C++）或 package.json / vite.config.ts（JS/TS），且被构建系统知晓；
- 测试可执行目标已正确定义（例如
add_executable(my_test test_main.cpp)+target_link_libraries(my_test PRIVATE my_module)）； - CLion 检测到了该目标，并在侧边栏“Tests”或“CMake”工具窗口中列出它。
如果没出现，检查 CMake 构建是否成功、enable_testing() 是否调用、add_test() 是否正确注册了测试项。CTest 模式下，CLion 依赖 ctest 的输出来生成运行配置；若 ctest -N 在终端里也列不出测试，那 IDE 就不可能识别。
Catch2 测试单个模块时常见的链接失败
你写了一个 TEST_CASE("my_module::parse_json")，但运行时报 undefined reference to 'my_module::parse_json(std::string const&)，说明测试目标没链接上你的模块实现。
典型修复步骤：
- 确认模块源码（如
src/parser.cpp）已被add_library(my_module STATIC ...)或add_library(my_module SHARED ...)构建； - 在测试目标中显式链接：
target_link_libraries(my_test PRIVATE my_module)； - 如果模块头文件路径未导出，补上：
target_include_directories(my_module PUBLIC $；$ - 避免把测试代码和模块实现混在一个 target 里——这会让“模块接口”变得模糊，也破坏了单元测试隔离性。
CTest 配置里 “Test list to run” 不生效
你在 CTest Application 配置中填了 Test list to run，但运行时还是全量执行，甚至报错 No tests were found。
这是因为：
-
Test list to run字段只接受ctest原生命令行中-R（正则匹配）或-L（标签过滤）能识别的格式，不是自由文本； - 如果你用的是 Catch2，需先在
add_test()中设置PROPERTIES LABELS "parser"，才能用-L parser过滤； - Google Test 默认不暴露标签，得靠
--gtest_filter=MyModule.*，这时应改用Google Test类型配置，而非 CTest； - 字段留空 = 运行全部；填错格式（如带空格、未转义括号）会导致 ctest 忽略该参数，静默回退到全量。
Vitest 调试时断点不命中
你在一个 describe('myModule', () => { it('handles edge case', () => { ... }) }) 里打了断点，点击装订区的 Debug 图标，但调试器跳过、或停在 node_modules 里。
常见原因：
- 源码映射（source map）未启用：检查
vite.config.ts中build.sourcemap是否为true，且测试运行时用的是开发构建（非build后产物）； - Vitest 配置中
test.environment设为node，但模块用了 DOM API；应改为jsdom并确保插件已安装； - CLion 的 Node.js 解释器路径指向了全局 npm 安装的
vitest，而非项目本地node_modules/.bin/vitest—— 这会导致调试器加载的代码与编辑器打开的不一致。
模块测试不是一键按钮，它依赖你明确声明“这个测试验证那个模块”，并在构建、链接、配置三层都对齐。最容易被忽略的，是 CMake 中 target_link_libraries 漏写、或 Vitest 的 source map 和运行环境错配——这两处一错，其他都白搭。
