CMake Tools执行ctest前自动构建：cmake.buildBeforeRun未生效

算力阿峰

2026-6-20

解决VS Code测试资源管理器运行CMake/CTest时的冗余构建问题

针对使用自定义CMake Preset、基于doctest+doctest_discover_tests集成CTest的项目，在VS Code测试资源管理器运行测试时总是触发冗余构建的问题，按以下步骤解决：

添加CTest专属禁用构建设置
仅设置cmake.buildBeforeRun不足以控制CTest集成的行为，测试资源管理器的CTest流程受单独配置管控，在settings.json中补充配置：
```
{
  "cmake.buildBeforeRun": false,
  "cmake.ctest.buildBeforeTest": false,
  "cmake.ctest.testExplorerIntegrationEnabled": true
}
```
确保构建目录已完成完整构建
先手动执行一次对应Preset的完整构建，让CTest能检测到已存在的测试可执行文件：
```
cmake --build --preset <你的预设名称>
```
修改CMakeLists.txt解除测试的构建依赖
doctest_discover_tests默认会给测试目标添加构建依赖，导致CTest强制触发前置构建，在调用该函数时添加参数解除依赖：
```
doctest_discover_tests(your_test_target
                       DISCOVERY_MODE POST_BUILD
                       PROPERTIES SKIP_BUILD_DEPENDENCY TRUE)
```
SKIP_BUILD_DEPENDENCY会告诉CTest，运行测试无需先构建测试目标。