# 核心转储调试

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

> **TL;DR**
> 操作系统  ：macOS / Linux / Windows
>
>
>
> 调试器  ：捆绑的 LLDB / 捆绑的 GDB / 工具链的 GDB / 自定义 GDB

CLion 支持使用 [核心转储](https://en.wikipedia.org/wiki/Core_dump)（macOS、Linux）和 [小型转储](https://docs.microsoft.com/en-us/troubleshoot/windows-client/performance/read-small-memory-dump-file)（Windows）文件进行事后调试。 这些文件是系统在程序崩溃或异常终止时捕获的进程内存副本。

由于唯一可用的数据是程序崩溃时的内存快照，因此无法 [逐步执行](stepping-through-the-program.html)程序，但您可以调查相应的源代码、帧和变量。 [内存视图](memory-view.html)、 [反汇编视图](disassembly-view.html)和 [调试器控制台](debugger-console.html)也可以使用。

Procedure: 配置核心转储调试会话

1. 使用以下选项之一：

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))）调用此操作。

如果项目中没有 [核心转储调试配置](core-dump-debug-configuration.html)，将直接显示打开核心转储对话框。 否则，从弹出菜单中选择   新建核心转储  。

![打开核心转储对话框](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debugcoredump_settingsdialog.png)

按照步骤 2 中的说明操作。

2.  手动创建   核心转储调试  配置。 转到   运行 | 编辑配置  ，点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，并从模板列表中选择 [核心转储调试](core-dump-debug-configuration.html)。

![核心转储调试配置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debugcoredump_settingsconfig.png)

2. 配置以下设置：

* 调试器 选择要使用的 [调试器](configuring-debugger-options.html)：捆绑的 LLDB、捆绑的 GDB、工具链的 GDB 或自定义外部 GDB。 默认调试器是捆绑的 LLDB（如果默认工具链配置为 LLDB），在所有其他情况下为捆绑的 GDB。 > **Note:** > Windows 小型转储无法使用 GDB 调试。 选择 GDB 作为调试器的选项适用于在 Windows 上打开 Linux/macOS 核心转储文件的情况。

* Core dump 提供 core dump 文件的路径或使用文件选择器选择它。 确保文件具有读取权限。 > **Tip:** > 在 Windows 上，核心转储存储在 `%LOCALAPPDATA%\CrashDumps` 目录中。 请参阅官方文档中的 [收集用户模式转储](https://docs.microsoft.com/en-us/windows/win32/wer/collecting-user-mode-dumps)。

* 符号文件 （LLDB 可选，GDB 必需） 符号文件是 CLion 正确识别程序符号并将您导航到正确的源代码位置所必需的。 这可以是带有调试信息的程序二进制构建文件或单独的符号文件。 请注意，链接库中没有调试信息的符号仅在相关调试符号位于默认搜索目录中时可用。 > **Tip:** > 如果您正在调试 共享对象库 ，请避免将 `.so` 文件指定为符号文件。 使用 `.so` 作为符号文件时，调试器会将源位置解析为两个位置：一个是内存中的实际地址，另一个是 `.so` 文件中的文件地址，而该地址不是有效的内存地址。 因此，逐步执行和其他调试操作无法正常工作。 LLDB: LLDB 可以检测与所选核心转储对应的二进制文件。 但是，如果您调查的崩溃发生在没有调试符号的二进制文件中，则需要明确提供这些符号给 LLDB。 为此，请指定未剥离版本的二进制文件或单独的符号文件的路径。 GDB: 对于 GDB，您需要手动指定未剥离的二进制文件或单独的符号文件。

* Sysroot 如果您正在调试来自另一个系统的二进制构建的核心转储，并且库位于非默认位置，请指定 `sysroot` 路径。

* 路径映射 如果二进制文件是在另一台机器上构建的，并且文件/目录名称或路径不同，请使用此窗格设置路径映射。

Procedure: 启动核心转储会话

* 对于   打开核心转储  操作，CLion 会创建相应的配置并自动启动它。

如果在项目中已有配置时调用   打开核心转储  ，它将打开配置列表，并提供创建新配置的选项：

![打开核心转储弹出窗口](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debugcoredump_popup.png)

* 如果您手动创建了   核心转储调试  配置，请在切换器中选择它并按 ![](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))）。

## 核心转储调试过程

当您启动核心转储调试会话时，CLion 会自动打开相应的源代码和 [调试工具窗口](debug-tool-window.html)。 与常规调试会话类似，您可以使用 Frames 选项卡和 Variables 面板，以及 [内存](memory-view.html)和 [反汇编](disassembly-view.html)视图。 [调试器控制台](debugger-console.html)也可用于运行调试器命令。

> **Note:**
> 请注意， [逐步执行](stepping-through-the-program.html)已禁用，并且带有进程输出的 Console 选项卡已隐藏。

![核心转储调试](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debugcoredump_process.png)

## 当前问题和限制

* 远程核心转储调试目前正在开发中（ [CPP-22656](https://youtrack.jetbrains.com/issue/CPP-22656)， [CPP-24333](https://youtrack.jetbrains.com/issue/CPP-24333)）。

* 在 macOS 上，捆绑的 GDB 可能会因 No core file handler recognizes format 错误而无法启动，这是 GDB 在 macOS 上的 [已知问题](https://sourceware.org/legacy-ml/gdb/2014-01/msg00035.html)。

* [求值表达式](examining-suspended-program.html#evaluating-expressions)功能可能会受到限制。

## See also

### 流程

[Debugging](debugging-code.html)

### 参考

[运行/调试配置：Core Dump Debug](core-dump-debug-configuration.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)

