# 分析外部堆栈跟踪

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

您可能需要分析他人收到的异常，以调查问题，例如死锁或无响应的用户界面。

使用 IntelliJ IDEA，您可以解码并查看异常堆栈跟踪或 [完整线程转储](thread-dumps.html)。 在查看期间，您可以使用它们导航到源代码，就像它们来自   运行   或   调试   工具窗口一样。

Procedure: 安装 ZKM-Unscramble 插件

此功能依赖于插件，您需要安装并启用它。

> **Note:**
> 在未订阅 Ultimate 的情况下，IntelliJ IDEA 中无法使用 ZKM-Unscramble 插件。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  ZKM-Unscramble  插件，然后点击   安装  。 如果出现提示，请重启 IDE。

Procedure:

1. 在主菜单中，前往  `编码 | 分析堆栈跟踪或线程转储文件` 。

2. 在   分析堆栈跟踪  对话框中打开后，将外部堆栈跟踪或线程转储粘贴到   请在此处放置堆栈跟踪或完整的线程转储：  文本区域中。

3. 请指定是否需要解码堆栈跟踪。

要做到这一点，请选择   解码堆栈跟踪   复选框，选择所需的 unscrambler 和日志文件。

4. 如果堆栈跟踪文本在使用某些软件处理（例如，错误跟踪器或邮件客户端）后损坏（行被截断或换行，或太长等），请点击   规范化  。

5. 如果您想显式指定包含相应 dSYM 文件的目录，请选择   使用附加目录搜索丢失的 dSYMs   复选框并在字段中输入所需的目录或从文件系统中选择。

6. 点击   OK  。 堆栈跟踪显示在 [运行](run-tool-window.html)工具窗口中。

要跳转到导致问题的代码，请滚动到所需的堆栈跟踪行并点击源文件的链接。 该文件会在编辑器中打开。

![在 Run 工具窗口中显示的线程转储](https://resources.jetbrains.com/help/img/idea/2026.3/analyze-thread-dump.png)

> **Tip:**
> 如果发生线程转储，IntelliJ IDEA 将以可读的方式呈现所有线程，并对其进行排序，以优先显示最可能导致死锁或挂起问题的线程。

线程名称旁边的图标表示线程的状态：

|  图标  |  描述  |
| --- | --- |
|  ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.resume.svg)  |  运行中/活动 – 默认状态，线程在此状态下正在主动执行代码  |
|  ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.debugger.threadRunning.svg)  |  （对于 Kotlin 协程）运行中 – 协程正在主动执行代码  |
|  ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.muteBreakpoints.svg)  |  休眠 – 在线程处于  `Thread.sleep` ，或者被挂起或正在等待条件时发生  |
|  ![](https://resources.jetbrains.com/help/img/idea/2026.3/未知](thread-dumps.html#kotlin_coroutines) 状态的协程  |
|  ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.debugger.threadFrozen.png)  |  等待 – 在线程正在等待对象监视器，或协程被挂起时发生  |
|  ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.debugger.threadStates.socket.svg)  |  套接字 – 在线程正在执行网络 I/O 时发生  |
|  ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.save.svg)  |  I/O – 在线程正在执行非网络 I/O 操作时发生  |
|  ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.status.success.svg)、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.profileCPU.png)  |  EDT（事件调度线程）– Swing 应用程序中的 UI 线程。 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.status.success.svg) 表示空闲 EDT， ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.profileCPU.png) 表示活动状态。  |

在   运行  工具窗口中的某些调用具有虚线下划线。 这些调用发生在  `try`  块内，并且可能抛出受检异常。

![Try Blocks Highlighting 功能会高亮显示运行工具窗口中的调用](https://resources.jetbrains.com/help/img/idea/2026.3/threaddump-underline.png)

## "分析堆栈跟踪对话框"

使用此对话框可获取外部应用程序的可导航控制台堆栈跟踪。 从此堆栈跟踪中的每条消息，您都可以直接导航到导致报告问题的源代码。

|  条目  |  描述  |
| --- | --- |
|  解码堆栈跟踪  |  如您的源代码已被加扰，请选择此复选框来解扰外部堆栈跟踪。  |
|  反混淆器  |     在这里，您可以选择解码工具。       IntelliJ IDEA 自带 Zelix Klass Master 解码插件。 您可以开发自己的插件，以破解由任何其他混淆器处理的代码的堆栈跟踪。     |
|  日志文件  |  请指定解码器日志文件的位置。  |
|  请在此处放置堆栈跟踪或完整的线程转储文件  |  请在此处粘贴外部堆栈跟踪或线程转储。  |
|  自动检测并分析复制到 IntelliJ IDEA 外部剪贴板的线程转储  |     如果选中此复选框，IntelliJ IDEA 将监控和分析剪贴板的内容。 您只能选中此复选框一次，每次切换到 IntelliJ IDEA 时，您的剪贴板将被扫描。       一旦类似堆栈跟踪的内容被复制到剪贴板，IntelliJ IDEA 会在相应的工具窗口中显示此堆栈跟踪。     |
|  高亮显示最近 <this_many> 天内更改的文件  |  选中此复选框以指定您想检查堆栈跟踪中最新更改的时间段。 默认时间周期设置为 31 天。  |
|  规范化  |  如果堆栈跟踪文本在使用某些软件（例如，bug 跟踪器或邮件客户端）处理后被损坏（行被截断或换行，或太长等），请点击此按钮以恢复正常的堆栈跟踪结构。  |

## See also

### 参考

[运行工具窗口](run-tool-window.html)

