为什么使用 CMake 构建时总是编译 Debug 版本？

在使用 CMake 构建项目时，很多开发者可能遇到过一个问题：明明想要生成 Release 版本，却总是默认编译成了 Debug 版本。这篇文章记录了我在使用 CMake 过程中遇到的相关问题及其解决方法。

理解 CMake 生成的本地构建系统

CMake 是一个跨平台的构建工具，它根据 CMakeLists.txt 文件生成特定于平台的本地编译系统。你可以通过 cmake -B 命令指定生成目标。例如，使用 -DCMAKE_BUILD_TYPE=Release 选项可以为 Makefile 或 Ninja 构建系统生成 Release 版本。然而，Visual Studio 和 Xcode 等 IDE 构建系统支持多目标（multi-configuration）编译，CMake 的行为有所不同。

单配置 vs. 多配置构建系统

对于像 Makefile 和 Ninja 这样的单配置构建系统，你可以通过 -DCMAKE_BUILD_TYPE 来指定编译类型。例如，生成 Release 版本时可以这样指定：

cmake -B build -DCMAKE_BUILD_TYPE=Release

这个选项会告诉 CMake 为 Release 模式生成适当的编译文件，一旦配置好，直接运行 cmake --build 即可编译出 Release 版本的程序。

Visual Studio 和 Xcode 的多配置模式

然而，在使用 Visual Studio 或 Xcode 这类多配置构建系统时，情况略有不同。因为这些 IDE 支持多个编译目标（如 Debug 和 Release）同时存在，你不能依赖 -DCMAKE_BUILD_TYPE=Release 来指定编译模式。

生成 Visual Studio 或 Xcode 项目时，只需运行如下命令：

cmake -B build -G "Visual Studio 17 2022"

此时，CMake 生成的解决方案文件默认包含多个配置。你可以在构建时通过 --config 选项来指定使用哪个配置。例如，要生成 Release 版本的程序，可以这样编译：

cmake --build build --config Release

在这种情况下，-DCMAKE_BUILD_TYPE 是不必要的，而且不会影响编译输出。

总结

在使用 CMake 时，需要根据你使用的构建系统决定如何指定编译类型：

• 对于 Makefile 和 Ninja 等单配置构建系统，使用 -DCMAKE_BUILD_TYPE=Release 即可。
• 对于 Visual Studio 和 Xcode 这类多配置构建系统，生成时不需要 -DCMAKE_BUILD_TYPE，而是在编译时使用 --config Release。

希望这篇文章能帮助大家更好地理解 CMake 中不同构建系统的行为，避免在生成 Release 版本时陷入 Debug 编译的困扰。