如何用CMake配置C++项目的Debug和Release编译模式

核心问题说明 #

MinGW Makefiles属于单配置生成器，这类生成器在CMake配置阶段就必须指定CMAKE_BUILD_TYPE，后续--config参数不会生效。而你想要的类似Visual Studio的多配置共享构建目录，需要用多配置生成器来实现，比如Ninja Multi-Config（推荐），或者通过单配置生成器配合共享配置的子目录方案。

方案一：使用Ninja Multi-Config生成器（最优解） #

这是最简洁的方式，完全匹配你预期的目录结构：

1. 编写根目录CMakeLists.txt #

使用CMake生成器表达式动态区分配置，设置输出路径：

cmake_minimum_required(VERSION 3.17) # Ninja Multi-Config要求CMake 3.17及以上
project(YourProjectName)

# 设置可执行文件输出目录：build/bin/Debug 或 build/bin/Release
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin/$<CONFIG>)

# 添加你的源文件（示例）
add_executable(YourExecutable src/main.cpp)

2. 初始化多配置构建环境 #

运行以下命令生成支持多配置的构建文件，无需提前指定构建类型：

cmake -B build -G "Ninja Multi-Config"

3. 分别构建Debug/Release版本 #

• 构建Debug版本：

cmake --build build --config Debug

• 构建Release版本：

cmake --build build --config Release

构建完成后，可执行文件会自动分别放入build/bin/Debug/和build/bin/Release/目录，完全符合你的需求。

方案二：兼容MinGW Makefiles的单配置多目录方案 #

如果必须使用MinGW Makefiles，可以通过在build下创建子目录区分配置，但共享根目录的CMake配置，避免重复设置：

1. 根目录CMakeLists.txt保持通用配置 #

cmake_minimum_required(VERSION 3.10)
project(YourProjectName)

# 通用配置：添加源文件、链接库、编译选项等
add_executable(YourExecutable src/main.cpp)

2. 初始化两个配置的构建子目录 #

# 初始化Debug构建环境，指定输出目录到build/bin/Debug
cmake -B build/Debug -G "MinGW Makefiles" -DCMAKE_BUILD_TYPE=Debug -DCMAKE_RUNTIME_OUTPUT_DIRECTORY=../bin/Debug

# 初始化Release构建环境，指定输出目录到build/bin/Release
cmake -B build/Release -G "MinGW Makefiles" -DCMAKE_BUILD_TYPE=Release -DCMAKE_RUNTIME_OUTPUT_DIRECTORY=../bin/Release

3. 分别构建 #

# 构建Debug版本
cmake --build build/Debug

# 构建Release版本
cmake --build build/Release

这种方式虽然build下会生成Debug和Release子目录，但所有项目核心配置都在根CMakeLists.txt中共享，不会出现配置混乱，最终可执行文件也会输出到你指定的目录。

原代码失效的原因 #

你之前的代码：

set(CMAKE_RUNTIME_OUTPUT_DIRECTORY${CMAKE_BINARY_DIR}/$<IF:$<CONFIG:Debug>,Debug,Release>)

存在两个问题：

1. 变量名和路径之间缺少空格，正确写法应为CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/...
2. 对于单配置生成器（如MinGW Makefiles），$<CONFIG>在配置阶段就被固定为指定的CMAKE_BUILD_TYPE，生成器表达式无法动态切换配置，只有多配置生成器能解析这种动态表达式。

内容的提问来源于stack exchange，提问作者Henrik Melfald Kittang