# 调试器选项

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

> **Note:**
> 从 CLion 2026.2 起，可使用 [调试分析](debug-profiles.html)选择并配置调试器，并可通过主工具栏在不同配置间切换。 工具链设置中的   调试器  字段已弃用。

CLion 允许使用以下调试器调试 C 和 C++ 可执行文件：

* macOS 和 Linux 上的 [LLDB](https://lldb.llvm.org)。

* Windows 和 Linux 上的 [GDB](https://www.gnu.org/software/gdb)。

* Windows 上适用于 MSVC 工具链的 [基于 LLDB 的调试器](quick-tutorial-on-configuring-clion-on-windows.html#msvc-debugger)。

* 所有平台上的自定义 GDB。

* macOS 和 Linux 上的自定义 LLDB（尚不适用于 WSL、Docker 或远程主机工具链）。

* 所有平台上支持 [调试适配器协议 (DAP)](dap-support.html) 的调试器。

捆绑调试器的当前版本如下：

|  捆绑调试器  |  Version  |  支持的平台  |
| --- | --- | --- |
|  LLDB  |  21.1.7},{  |  macOS、Linux  |
|  GDB  |  17.1  |  Windows、Linux  |
|  适用于 MSVC 工具链的 LLDB  |  9.0.0*  |  Windows  |

> **Note:**
> 为什么在 MSVC 工具链中使用 LLDB v9.0.0 。 这是一个经过大量修改的 LLDB 复刻，在处理 PDB 文件的性能和准确性方面有显著改进，并且支持 Natvis 框架。 这些更改对于使用 MSVC 工具链进行有效调试至关重要。 因此，目前无法将其他 LLDB 版本与 MSVC 工具链配合使用，也没有更新该版本的方案。

Procedure: 在调试器之间切换

1. 在主工具栏的调试分析切换器中选择调试分析。 切换器将当前分析显示为   调试 | <profile>  。

![主工具栏调试分析切换器※](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_profiles_switcher.png)

2. 如需添加或编辑分析，请前往  `设置 | 构建、执行、部署 | 调试器 | 调试配置文件},{` 。 有关更多信息，请参阅 [调试分析](debug-profiles.html)。

## 调试器数据视图

在  `设置 | 构建、执行、部署 | 调试器 | 数据视图 | C/C++`  对话框中，您可以自定义 C/C++ 数据表示。

![C/C++ 调试器数据视图设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debugger_dataviews_cpp.png)

在这里，您可以控制标准库类型的渲染、模块名称、函数参数类型和函数模板参数等选项。 或者，使用 [调试工具窗口](debug-tool-window.html)、Frames 视图和 Variables 视图中的上下文菜单：

![变量视图上下文选项](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debugtw_variables_contextoptions.png)

### STL 容器渲染

设置   启用 GNU 库渲染器   复选框后，在使用  gcc  编译器时，这会影响 GDB 对 STL 容器的渲染。 对于与 GDB 成对使用的  clang ，此选项仅适用于  `libstdc++` （有关更多信息，请参阅 [下一章](#gdb-config)）。

当前此选项不适用于 LLDB。 请查看 LLDB（从版本 9.0 开始）如何在下面的   LLDB STL 格式化器   中处理  `libc++`  和  `libstdcxx` 。

#### LLDB STL 格式化器

以下列出的内容适用于 LLDB 版本 9.0。

macOS:

|  Type  |  libcxx  |  libstdc++  |
| --- | --- | --- |
|  字符串  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  数组  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  向量  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  双端队列  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  列表  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  前向列表  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  set  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  map  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  多重集合  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  多重映射  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  unordered_set  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  无序映射  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  无序多重集合  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  无序多重映射  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  栈  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  队列  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  优先队列  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |

Ubuntu:

|  Type  |  libcxx  |  libstdc++  |
| --- | --- | --- |
|  字符串  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png) 如果使用  `-fstandalone-debug`  编译  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  数组  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  向量  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  双端队列  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  列表  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  前向列表  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  set  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  map  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  多重集合  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  多重映射  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  unordered_set  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  无序映射  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  无序多重集合  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  无序多重映射  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  栈  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  队列  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  优先队列  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |

#### 用于 macOS 的 GDB 的 STL 渲染器

将   GDB   用作调试后端并结合   Clang  （   CMake   默认编译器）时，在 macOS 上查看 STL 容器内容存在限制。 作为解决方法，请尝试以下说明。

Procedure:

1. 使用  `libstdc++`  库代替  `libc++` 。 要在项目中包含  `libstdc++` ，请在 [CMakeLists.txt](cmakelists-txt-file.html) 中添加以下命令：

```CMAKE
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -stdlib=libstdc++")

```

或者，转到  `设置 | 构建、执行、部署 | CMake` ，并在   CMake 选项   字段中指定库：

```
-DCMAKE_CXX_FLAGS="-stdlib=libstdc++"

```

> **Note:**
> libstdc++  提供了 C++ 在  GCC 4.2.1  级别的支持。 如需了解更多信息，请参阅 [http://libcxx.llvm.org/](http://libcxx.llvm.org/)。

2. 我们还建议您使用  dwarf3  调试信息格式。 为此，请将以下命令添加到您的  `CMakeLists.txt` ：

```CMAKE
set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} -gdwarf-3")
set(CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} -gdwarf-3")

```

## 自定义 .gdbinit/.lldbinit 文件

如果您的项目需要更多的调试配置选项，您可以创建一个自定义初始化文件， [.gdbinit](https://sourceware.org/gdb/current/onlinedocs/gdb.html/Initialization-Files.html) 用于 GDB 或 [.lldbinit](https://lldb.llvm.org/man/lldb.html#configuration-files) 用于 LLDB，并将其放置在项目根目录下。 此文件可以通过 [VCS](version-control-integration.html) 与其他项目文件一起共享。

> **Tip:**
> 请注意，  `.gdbinit`  /  `.lldbinit`  文件并不与 IDE 绑定，在 CLion 之外使用时也能正常工作。

通常，GDB/LLDB 在启动时会按一定顺序加载多个初始化文件。 首先，调试器会在用户的主目录中查找初始化文件，然后在当前工作目录（您的项目根目录）中查找文件。

默认情况下，出于安全原因，不会执行项目特定初始化文件中的命令。 要允许执行，请按照以下描述修改主目录中的初始化文件。

Procedure: 启用读取项目特定的 .gdbinit/.lldbinit

GDB:

在  `~/.gdbinit`  文件中设置权限。

对于 GDB 11.1 及更新版本，可以改用  `$HOME/.config/gdb/gdbinit`  或  `$HOME/Library/Preferences/gdb/gdbinit` 。

在使用 [WSL](how-to-use-wsl-development-environment-in-product.html) 时，编辑位于 WSL 主目录中的  `.gdbinit`  文件，  `/home/[user]/.gdbinit` 。

* 适用于所有项目 ```CONSOLE set auto-load local-gdbinit on add-auto-load-safe-path / ``` > **Note:** > 这允许调试器读取所有项目的项目特定初始化文件，包括使用命令行 GDB 并允许其从当前工作目录读取 `.gdbinit` 。 请注意，这可能导致执行不受信任的命令。

* 适用于特定项目 ```CONSOLE set auto-load local-gdbinit on add-auto-load-safe-path [full path to the project root]/.gdbinit ```

LLDB:

在主目录的  `~/.lldbinit`  文件中设置权限：

```CONSOLE
settings set target.load-cwd-lldbinit true
```

> **Note:**
> 这允许调试器读取所有项目的项目特定初始化文件，包括使用命令行 LLDB 并允许其从当前工作目录读取  `.lldbinit` 。 请注意，这可能导致执行不受信任的命令。

## 调整 GDB 超时值

您可以通过在 CLion 注册表中设置相应的属性来控制 GDB 超时值。

Procedure:

1. 请按 `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `⌘ ⇧ A` (Xcode), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+Shift+A` (ReSharper), `⌘ ⇧ A` (ReSharper (macOS)), `Ctrl+Shift+A` (QtCreator), `⌘ ⇧ A` (QtCreator (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS)) 或从主菜单中选择  `帮助 | 查找操作` 。 在打开的弹出窗口中，开始输入  `Registry` ，选择相应的项目并按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

![在“查找操作”中搜索注册表](https://resources.jetbrains.com/help/img/idea/2026.3/cl_findaction_registry.png)

2. 在打开的对话框中，开始输入   cidr.debugger.timeout  。 点击高亮字符串的   Value   字段，并以毫秒为单位输入超时值。

![GDB 超时的注册表键](https://resources.jetbrains.com/help/img/idea/2026.3/cl_registryDebuggerTimeout.png)

## 在 Windows 上配置外部 GDB 控制台

在 Windows 上，使用 GDB 8.0 之前的版本时，会为应用程序输入/输出使用单独的控制台。 对于较新的 GDB 版本，输出默认重定向到 CLion 控制台。 但是，您可以切换回打开外部输出窗口。

Procedure:

1. 请按 `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `⌘ ⇧ A` (Xcode), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+Shift+A` (ReSharper), `⌘ ⇧ A` (ReSharper (macOS)), `Ctrl+Shift+A` (QtCreator), `⌘ ⇧ A` (QtCreator (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS)) 或从主菜单中选择  `帮助 | 查找操作` 。 在打开的弹出窗口中，开始输入  `Registry` ，选择相应的项目并按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

![在“查找操作”中搜索注册表](https://resources.jetbrains.com/help/img/idea/2026.3/cl_findaction_registry.png)

2. 在打开的对话框中，开始输入   cidr.debugger.gdb.workaround.windows.forceExternalConsole  。 点击高亮显示字符串的   Value   字段。

![启用 Windows 上外部 GDB 控制台的注册表键](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gdbexternalconsole_windows.png)

## 编译时求值

[Constexpr 调试器](constexpr-debugger.html)可让你从编译器的角度了解实际发生的情况 - 通过步进求值、检查值，并确认触发了哪个  `if constexpr`  分支。 此工具可帮助你准确了解编译器正在执行的操作，并更快修复问题。

## 启用调试器日志记录

当需要诊断调试器问题，例如会话无法启动时，CLion 可以将详细的调试器诊断信息写入 IDE 日志。 此时，日志会包含 IDE 与调试器后端之间的完整消息流量，适用于 GDB、LLDB 和 [DAP](dap-support.html) 会话。

Procedure: 记录调试器诊断信息

1. 从主菜单中选择  `帮助 | 诊断工具 | 调试日志设置……` 。

2. 在   自定义调试日志配置   对话框中，将以下类别单独添加在一行中：

```
com.jetbrains.cidr.execution.debugger
```

![自定义调试日志配置对话框，其中 CLion 调试器日志类别已单独添加在一行中。](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_log_settings.png)

此类别以  `DEBUG`  级别记录，因此无需追加级别后缀。

3. 通过启动调试会话来重现问题。

4. 检查  `idea.log` ，位于 [日志目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#logs-directory) 中。

要停止日志记录，请重新打开对话框并移除该类别。

## See also

### 操作指南

[Quick Tutorial: Configure CLion on Windows](quick-tutorial-on-configuring-clion-on-windows.html) [教程：在 macOS 上配置 CLion](quick-tutorial-on-configuring-clion-on-macos.html)

### 外部链接

[CLion Debugging Beyond the Basics - Part 3 - Beyond Local](https://blog.jetbrains.com/clion/2021/05/clion-debugging-beyond-the-basics-part-3-beyond-local)

