如何在CMakeLists.txt/CMakePresets.json中设置Release编译模式？

问题背景 #

• 环境：VSCode（Windows）、Visual Studio 18 2026编译器
• 核心需求：无需命令行，仅通过编辑器底部构建按钮完成Release模式编译，需兼容vcpkg包管理器及google/benchmark库
• 当前问题：命令行cmake --build . --config Release可正常构建，但通过CMakeLists.txt/CMakePresets.json配置无效；CMake Tools扩展存在状态栏按钮缺失、"CMake: Select Variant"选项消失的异常

一、通过CMakeLists.txt指定默认Release模式 #

针对VS这类多配置生成器，不能仅依赖CMAKE_BUILD_TYPE，需同时配置多配置专属变量：

# 强制多配置生成器（如VS）默认使用Release
if(CMAKE_CONFIGURATION_TYPES)
  set(CMAKE_CONFIGURATION_TYPES Release CACHE STRING "Build configurations" FORCE)
  mark_as_advanced(CMAKE_CONFIGURATION_TYPES)
endif()

# 兼容单配置生成器的Release设置
set(CMAKE_BUILD_TYPE Release CACHE STRING "Build type" FORCE)

# vcpkg集成配置（替换为你的vcpkg路径）
set(CMAKE_TOOLCHAIN_FILE "${VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake" CACHE STRING "Vcpkg toolchain file")

# google/benchmark链接示例
find_package(benchmark REQUIRED)
add_executable(bench_demo bench_main.cpp)
target_link_libraries(bench_demo PRIVATE benchmark::benchmark)

注：FORCE参数强制覆盖CMake默认配置，mark_as_advanced避免用户在GUI中误修改配置类型。

二、通过CMakePresets.json指定默认Release（推荐） #

使用CMake官方预设方案，不污染业务CMakeLists.txt，同时明确绑定配置：

{
  "version": 3,
  "configurePresets": [
    {
      "name": "release-default",
      "generator": "Visual Studio 18 2026",
      "binaryDir": "${sourceDir}/build/Release",
      "cacheVariables": {
        "CMAKE_TOOLCHAIN_FILE": "$env{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake"
      },
      "environment": {
        "VCPKG_ROOT": "C:/your/vcpkg/path" // 替换为实际vcpkg路径
      }
    }
  ],
  "buildPresets": [
    {
      "name": "release-default",
      "configurePreset": "release-default",
      "configuration": "Release"
    }
  ]
}

配置完成后，在VSCode命令面板执行CMake: Select Configure Preset选择release-default，之后底部构建按钮会默认使用Release模式。

三、修复CMake Tools扩展异常 #

1. 重置扩展状态：打开命令面板（Ctrl+Shift+P），执行CMake: Reset CMake Tools，重启VSCode
2. 重装扩展：卸载CMake Tools后，重启VSCode再重新安装
3. 检查用户配置：确保settings.json中无冲突配置，示例：

{
  "cmake.configureOnOpen": true,
  "cmake.defaultPreset": "release-default" // 与presets中的名称对应
}

4. 清理缓存：手动删除项目下的build目录，重新执行CMake: Configure

验证方法 #

1. 保存配置后执行CMake: Configure
2. 点击VSCode底部的构建按钮
3. 检查build/Release目录下的输出文件，确认google/benchmark链接的是Release版本（vcpkg会自动匹配配置）

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