通过在 cmakelists.txt 中启用调试输出和设置 cmake_verbose_makefile 环境变量，可查看 cmake 运行时的详细调试消息。 查看 cmake 日志，如 visual studio 的输出窗口、xcode 的构建日志或 unix/linux 终端中的文本输出。 请确保 cmake 版本支持调试输出且 cmake_verbose_makefile 设置正确。

如何使用 CMake 调试 C++ 项目配置

导言

CMake 是一个跨平台的构建系统，用于生成特定平台的项目文件，例如 Visual Studio、Xcode 或 Makefiles。在开发 C++ 项目的过程中，调试 CMake 配置至关重要，以确保项目的正确构建和执行。

实战案例

假设您有一个名为 my_cpp_project 的 C++ 项目，其目录结构如下：

├── CMakeLists.txt
├── src
│   ├── main.cpp

1. 启用 CMake 调试输出

要在 CMake 运行时查看详细的调试消息，可以在 CMakeLists.txt 文件中添加以下行：

message(STATUS "Hello from CMake!")

2. 设置 CMAKE_VERBOSE_MAKEFILE

此环境变量控制 CMake 生成的构建系统（例如 Makefile 或 Visual Studio 项目）的详细程度。将其设置为 1 以启用详细记录：

set(CMAKE_VERBOSE_MAKEFILE 1)

查看 CMake 日志

• Visual Studio: CMake 输出位于 输出 窗口中。
• Xcode: CMake 输出位于 构建日志 中。
• Unix/Linux: CMake 输出以文本形式打印到终端。

实践示例

让我们使用我们的示例项目进行调试：

1. 在 CMakeLists.txt 中添加调试消息和 CMAKE_VERBOSE_MAKEFILE 设置。
2. 运行 CMake 配置命令（例如 cmake .）。
3. 查看 CMake 日志以查找调试消息。

故障排除提示

• 如果在日志中看不到 CMake 消息，请检查您的 CMake 版本是否支持调试输出（最低要求 CMake 3.15）。
• 确保正确设置了 CMAKE_VERBOSE_MAKEFILE 环境变量。
• 审查 CMake 文档以了解更多故障排除技巧和选项。