如何让VSCode的CMake Tools扩展成功执行带覆盖率的测试？

问题概述 #

使用VS Code搭配CMake Tools扩展，点击"Run Tests With Coverage"选项后，测试执行成功，但始终提示No coverage info files for CMake project...，无法生成覆盖率报告。但在命令行执行ctest -T Test -T Coverage可以正常生成完整的覆盖率统计。

核心原因 #

从扩展的执行日志可以看到，它调用的ctest命令仅包含-T test参数，仅完成测试执行环节，没有触发覆盖率收集的-T Coverage步骤；而命令行通过同时指定两个-T参数，完成了测试执行+覆盖率分析的完整流程。

解决办法 #

方法1：修改CMake Tools配置，强制触发覆盖率步骤 #

在VS Code的settings.json中添加配置，让扩展执行测试时自动带上覆盖率参数：

{
  "cmake.testArgs": [
    "-T", "Coverage",
    "--output-on-failure",
    "-R", "^UnitTests$"
  ]
}

如果需要针对不同构建配置单独设置，可以用以下格式：

{
  "cmake.testArgs": {
    "Debug": [
      "-T", "Coverage",
      "--output-on-failure",
      "-R", "^UnitTests$"
    ]
  }
}

方法2：优化CMakeLists.txt的覆盖率配置 #

确保仅在Debug模式下启用覆盖率编译/链接参数，避免冗余配置干扰：
根目录CMakeLists.txt修改为：

cmake_minimum_required(VERSION 3.22)

project(sandbox)

include_directories(include)

enable_testing()

# 仅Debug模式启用覆盖率
if(CMAKE_BUILD_TYPE STREQUAL "Debug")
  set(GCC_COVERAGE_COMPILE_FLAGS "-g -O0 -coverage -fprofile-arcs -ftest-coverage")
  set(GCC_COVERAGE_LINK_FLAGS    "-coverage -lgcov")
  set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} ${GCC_COVERAGE_COMPILE_FLAGS}")
  set(CMAKE_EXE_LINKER_FLAGS_DEBUG "${CMAKE_EXE_LINKER_FLAGS_DEBUG} ${GCC_COVERAGE_LINK_FLAGS}")
endif()

add_subdirectory(tests)

tests目录CMakeLists.txt可以去掉重复的-coverage参数，简化为：

find_package(Catch2 2 REQUIRED)

include(CTest)

add_executable(tests test.cpp ../lib/lib.cpp)

set(CMAKE_BUILD_TYPE "Debug")

target_link_libraries(tests PRIVATE Catch2::Catch2WithMain)

add_test(NAME UnitTests COMMAND tests)

方法3：手动执行完整流程 #

如果扩展自动调用仍有问题，可在VS Code终端手动执行以下命令：

cd build
cmake --build . --config Debug
ctest -T Test -T Coverage -R ^UnitTests$

执行完成后，CMake Tools会自动识别生成的覆盖率文件并展示报告。

额外检查点 #

• 清空build目录后重新构建，避免旧编译文件干扰
• 确认gcc版本支持-coverage和gcov（现代gcc版本均支持）
• 将CMake Tools扩展更新到最新版本，修复潜在兼容性问题

内容的提问来源于stack exchange，提问作者spierepf