# CMake 调试

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

> **TL;DR**
> CMake 可执行文件  ：捆绑版本，3.24.2 或更高版本
>
>
>
> 操作系统  ：macOS / Linux / Windows
>
>
>
> WSL / 远程 / Docker 工具链  ：不支持

CLion CMake 调试器可以帮助您识别并修复 [CMake 脚本](cmakelists-txt-file.html) 中的错误或不期望的行为。

对于 CMake 版本 3.27 及更高版本，CLion 使用 [调试适配器协议](https://microsoft.github.io/debug-adapter-protocol/)（DAP）。 您还可以在 [高级设置](advanced-settings.html#advanced_cmake)中切换到基于 [Sysprogs 提供的 CMake 脚本调试器](https://sysprogs.com/w/introducing-cmake-script-debugger/) 的实现。

> **Note:**
> 调试器仅适用于 CMake 配置步骤。 它不会调试您的实际项目构建，并且在调试状态下执行 CMake 后，项目模型不会被 [重新加载](reloading-project.html)。

Procedure: 调试失败的 CMake 生成

1. 如果 CMake 生成失败，请点击 CMake 工具窗口中的   调试   提示：

![CMake 工具窗口中的调试提示](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_debug_tw_hint.png)

2. CLion 将启动调试会话，并将您定位到代码中的相应位置：

![从 CMake 工具窗口启动的调试会话](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_debug_failed_fromhint.png)

Procedure: 从编辑器启动 CMake 调试会话

> **Note:**
> 在开始调试会话之前，请等待您的项目加载/重新加载并完成项目分析。

* 打开顶层  `CMakeLists.txt` ，点击第一个命令旁的标记栏图标，然后选择   调试  ：

![从边距启动 CMake 调试会话](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_boost_debug_gutter.png)

以这种方式启动调试会话时，CLion 会创建一个类型为   CMake 调试   的临时配置。 您可以将其 [保存](run-debug-configuration.html#save-as-permanent)以供后续使用，并创建更多此类型的配置。 有关更多信息，请参阅下一部分。

Procedure: 创建并启动 CMake 调试配置

1. 在主菜单中，进入  `运行 | 编辑配置` .

2. 请点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 工具栏上的图标或按下 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) 键。 从模板列表中选择   CMake 调试  ：

![添加 CMake 调试配置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_debug_config_add.png)

3. 为您的配置设置名称，并根据需要添加 [启动前](running-cmake-targets-before-launch.html)步骤。

4. 在切换器中选择新创建的配置，然后点击 ![调试按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.startDebugger.svg) 或按 `Shift+F9` (Windows), `⌃ D` (macOS), `⇧ F9` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ D` (macOS System Shortcuts), `Shift+F9` (XWin), `Shift+F9` (GNOME), `Shift+F9` (KDE), `Shift+F9` (Emacs), `Shift+F9` (Sublime Text), `⌃ D` (Sublime Text (macOS)), `⌘ R` (Xcode), `Alt+F5` (Visual Studio), `⌥ F5` (Visual Studio (macOS)), `Alt+F5` (ReSharper), `⌥ F5` (ReSharper (macOS)), `F5` (QtCreator), `⌘ Y` (QtCreator (macOS)), `Ctrl+F5` (NetBeans), `Alt+Shift+D` (Eclipse), `⌘ F11` (Eclipse (macOS))。

## CMake 调试功能

CMake 调试器包含 CLion 提供的许多通用调试功能。 例如，您可以设置 [断点](using-breakpoints.html)、 [逐步执行](stepping-through-the-program.html)代码、 [监视](examining-suspended-program.html#watches) CMake 变量，并在编辑器中探索 [内联](examining-suspended-program.html#inline-view)的值：

![调试会话示例](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_debug_session_example.png)

## See also

### 教程

[快速 CMake 教程](quick-cmake-tutorial.html)

### 操作指南

[CMake 配置文件](cmake-profile.html) [工具链](how-to-create-toolchain-in-clion.html)

### 调试

[检查挂起的程序](examining-suspended-program.html) [在启动前运行 CMake 目标](running-cmake-targets-before-launch.html)

