如何简化跨平台C++ CMake项目Debug/Release构建切换流程？

我们有一个C++ CMake项目，我在Windows平台使用Visual Studio 2019开发，同事在Ubuntu平台使用QTCreator开发。

当前我从DEBUG切换到RELEASE构建的步骤如下：

配置VTK #

• 在Visual Studio中打开VTK的Release构建文件夹，构建“INSTALL”子项目，用Release版本覆盖已安装的Debug版本VTK。

配置项目 #

• 编辑账户的PATH环境变量，将路径从myProject\lib\analytics\Debug改为myProject\lib\analytics\Release，否则程序找不到DLL无法运行，不确定Visual Studio有没有自动查找DLL的方法。
  
• 编辑项目顶层CMake文件，添加：

SET(BUILD_MODE Release)
set(CMAKE_BUILD_TYPE "RELEASE" CACHE STRING "Sets release build by default")

• 打开CMake-GUI，清除缓存后运行“Configure”和“Generate”，不清除缓存会导致构建异常。
• 在Visual Studio中打开项目，将顶部构建类型改为Release。
• 对ALL_BUILD执行“Rebuild”操作。

请问有没有办法简化该流程，让Debug/Release切换更轻松？我对Visual Studio和CMake不熟悉，不清楚遗漏了哪些功能。

1. 保留VTK的Debug和Release独立版本，避免覆盖安装 #

不要用Release版本覆盖Debug版VTK，为两种配置分别创建独立的构建与安装目录，比如：

• Debug版本：D:\VTK\build-debug 和 D:\VTK\install-debug
• Release版本：D:\VTK\build-release 和 D:\VTK\install-release

然后在项目CMakeLists中通过条件判断自动匹配对应版本的VTK，无需每次切换都重新安装：

if(CMAKE_BUILD_TYPE STREQUAL "Debug")
  set(VTK_DIR "D:/VTK/install-debug/lib/cmake/vtk-xxx")
else()
  set(VTK_DIR "D:/VTK/install-release/lib/cmake/vtk-xxx")
endif()
find_package(VTK REQUIRED)

2. 让Visual Studio自动查找DLL，无需手动修改PATH #

有两种实用方案：

• 方案一：CMake自动复制DLL到输出目录
  在项目CMakeLists中添加代码，将依赖的DLL自动同步到可执行文件所在目录：

# 假设你的可执行目标是myApp
add_executable(myApp ...)

# 复制Debug版本依赖DLL
add_custom_command(TARGET myApp POST_BUILD
  COMMAND ${CMAKE_COMMAND} -E copy_directory
  ${CMAKE_SOURCE_DIR}/lib/analytics/Debug
  $<TARGET_FILE_DIR:myApp>
  COMMAND ${CMAKE_COMMAND} -E copy_directory
  $<TARGET_FILE_DIR:VTK::CommonCore>
  $<TARGET_FILE_DIR:myApp>
  COMMENT "Copying Debug DLLs..."
  VERBATIM
)

# 复制Release版本依赖DLL
add_custom_command(TARGET myApp POST_BUILD
  COMMAND ${CMAKE_COMMAND} -E copy_directory
  ${CMAKE_SOURCE_DIR}/lib/analytics/Release
  $<TARGET_FILE_DIR:myApp>
  COMMAND ${CMAKE_COMMAND} -E copy_directory
  $<TARGET_FILE_DIR:VTK::CommonCore>
  $<TARGET_FILE_DIR:myApp>
  COMMENT "Copying Release DLLs..."
  VERBATIM
)

构建后可执行文件目录会自动包含所需DLL，无需修改PATH。

• 方案二：配置Visual Studio调试环境
  右键项目 → 属性 → 调试 → 环境，添加：

PATH=$(SolutionDir)lib\analytics\$(Configuration);$(PATH)

$(Configuration)会自动匹配当前的Debug/Release模式，无需手动调整。

3. 无需修改CMakeLists或清除缓存，直接在VS中切换构建类型 #

Visual Studio是多配置生成器，CMake原生支持在VS中直接切换构建类型：

• 移除顶层CMake中硬编码的SET(BUILD_MODE Release)和set(CMAKE_BUILD_TYPE "RELEASE" CACHE ...)，多配置生成器会忽略这类固定缓存值。
• 直接在Visual Studio顶部的构建类型下拉菜单选择Debug/Release，CMake会自动适配对应配置重新构建，无需重新运行CMake-GUI。

如果需要针对不同配置设置差异化参数，可用$<CONFIG>生成器表达式：

target_link_libraries(myApp
  PRIVATE
  ${CMAKE_SOURCE_DIR}/lib/analytics/$<CONFIG>/analytics.lib
)

4. 避免每次切换都执行Rebuild #

只要CMake配置正确，切换构建类型时直接Build即可。若出现旧文件干扰，可在CMake中添加：

set(CMAKE_SUPPRESS_REGENERATION true)

减少不必要的重新生成，确保VS仅构建当前配置的目标文件。

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