# 线程转储

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

线程转储文件是一种用于检查应用程序在特定时刻状态的工具。 其中包含应用程序中的线程列表及其堆栈跟踪，可用于调试死锁或 UI 无响应等问题。 线程转储文件的主要优势在于其纯文本格式，以及有大量可捕获和处理它们的工具。

IntelliJ IDEA 可用于捕获正在运行进程的线程转储文件，也可解析在 IntelliJ IDEA 或其他工具中获取的外部线程转储文件，例如  `jstack`  和  `jcmd` 。

IntelliJ IDEA 支持最高版本 25 的 JDK 工具生成的格式。

> **Note:**
> 线程转储文件的内容和格式可能会因捕获它所用的工具而异。 例如，IntelliJ IDEA 会转储 Kotlin 协程和 Java 虚拟线程及其捕获时的状态，而其他工具捕获的线程转储文件中可能没有这些信息。

Procedure: 从 IntelliJ IDEA 捕获线程转储

1. 从 IntelliJ IDEA 运行程序时：在   运行   工具窗口的工具栏上，点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.dump.svg)   线程转储  。

![运行工具窗口工具栏上的转储线程按钮](https://resources.jetbrains.com/help/img/idea/2026.3/ij_run_dump_threads.png)

> **Tip:**
> 对   线程转储   按钮执行 `Alt+Click` (Windows), `Alt+Click` (macOS), `Alt+Click` (IntelliJ IDEA Classic (macOS)), `Alt+Click` (macOS System Shortcuts), `Alt+Click` (XWin), `Alt+Click` (GNOME), `Alt+Click` (KDE), `Alt+Click` (Emacs), `Alt+Click` (Sublime Text), `Alt+Click` (Sublime Text (macOS)), `Alt+Click` (Visual Studio), `Alt+Click` (Visual Studio (macOS)), `Alt+Click` (NetBeans), `Alt+Click` (Eclipse), `Alt+Click` (Eclipse (macOS))，以仅捕获 Java 平台线程。 这会跳过虚拟线程，因为收集它们需要额外时间。

2. 从 IntelliJ IDEA 调试程序时：在   调试   工具窗口的工具栏上，点击 ![更多](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.moreVertical.svg)   更多  ，然后选择 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.dump.svg)   获取线程转储文件  。

![调试工具窗口工具栏上的“更多”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/ij_debug_more.png)

> **Tip:**
> 对   获取线程转储文件   项执行 `Alt+Click` (Windows), `Alt+Click` (macOS), `Alt+Click` (IntelliJ IDEA Classic (macOS)), `Alt+Click` (macOS System Shortcuts), `Alt+Click` (XWin), `Alt+Click` (GNOME), `Alt+Click` (KDE), `Alt+Click` (Emacs), `Alt+Click` (Sublime Text), `Alt+Click` (Sublime Text (macOS)), `Alt+Click` (Visual Studio), `Alt+Click` (Visual Studio (macOS)), `Alt+Click` (NetBeans), `Alt+Click` (Eclipse), `Alt+Click` (Eclipse (macOS))，以仅捕获 Java 平台线程。 这会跳过虚拟线程和 Kotlin 协程，因为收集它们需要额外时间。

3. 对于本地运行的任何 Java/Kotlin 进程：在   分析器   工具窗口的   首页   选项卡上，点击要为其创建线程转储文件的进程。 选择   获取线程转储文件  。

![右键点击 Profiler 工具窗口中的进程时，会打开一个菜单](https://resources.jetbrains.com/help/img/idea/2026.3/home-tab-thread-dump.png)

> **Note:**
> 来自   运行   工具窗口的线程转储文件包含虚拟线程。 只有在调试模式下启动的程序才会捕获 Kotlin 协程。

Procedure: 打开外部线程转储文件

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

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

线程转储文件会在新的工具窗口选项卡中打开。 此视图是可自定义的：您可以应用筛选和排序，合并相似的线程，并部分折叠堆栈跟踪。

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

|  图标  |  描述  |
| --- | --- |
|  ![](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/app.expui.debugger.threads.svg)  |  载体线程 – 当前正在执行虚拟线程的平台线程，或处于 [已创建/未知](#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) 表示活动状态。  |

此外，波浪形的叠加层表示虚拟线程和 Kotlin 协程，而"幽灵"叠加层表示守护线程：

![线程转储文件中指示虚拟线程和守护线程的叠加标记](https://resources.jetbrains.com/help/img/idea/2026.3/ij-thread-dump-overlays.png)

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

如果您想检查出现在堆栈跟踪中的类，您可以直接从线程转储导航到它。

Procedure: 跳转到源

* 点击堆栈跟踪中的超链接。

![线程转储中的超链接](https://resources.jetbrains.com/help/img/idea/2026.3/thread-dump-jump-to-source.png)

> **Note:**
> 如果行引用未显示为超链接，则表示源代码在项目代码和依赖项中不可用。

如果您想保存线程转储以供以后检查或发送给其他人，您可以将其导出为文本文件。

Procedure: 将线程转储导出为文本文件

1. 在工具栏上，点击   导出到文本文件   。

![线程转储文件查看器中的“导出到文本文件”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/export-thread-dump.png)

2. 指定路径，然后点击   保存   。

## IntelliJ IDEA 的线程转储文件格式

以文本格式查看 IntelliJ IDEA 的线程转储文件时，可能会注意到线程描述和堆栈跟踪中包含额外信息。

其显示效果示例如下：

```
"main" prio=5 tid=0x000001f3c9d13000 nid=NA runnable
  java.lang.Thread.State: RUNNABLE
    at java.net.SocketInputStream.socketRead0(Native Method)
    at java.net.SocketInputStream.socketRead(SocketInputStream.java:116)
    at java.net.SocketInputStream.read(SocketInputStream.java:171)
    at java.net.SocketInputStream.read(SocketInputStream.java:141)
    at sun.nio.cs.StreamDecoder.readBytes(StreamDecoder.java:284)
      - locked <0x00000007ab1d3fa8> (a java.io.InputStreamReader)
    at sun.nio.cs.StreamDecoder.implRead(StreamDecoder.java:326)
    at sun.nio.cs.StreamDecoder.read(StreamDecoder.java:178)

```

转储文件中的每个线程都由以下信息表示：

### 线程页眉行

```
"Thread-Name" [state flags] prio=N tid=0xHEXVALUE nid=NA [thread state]

```

线程页眉行位于每个线程描述的开头，包含：

* 引号中的线程名称

* 用于指示线程是否为守护线程或虚拟线程的可选标志

* 线程优先级（ `prio` ）– 由 JVM 管理的值，表示线程的调度优先级，范围从 1（最低）到 10（最高）。 默认值为 5。 这些优先级可以映射到 OS 级线程优先级，但映射取决于实现，并且优先级只是给调度器的提示，而不是执行顺序的保证。

* 十六进制线程 ID（ `tid` ）

* 原生 ID ( `nid` ) – 在 IDE 生成的转储文件中通常为 `NA` 。 此信息通常仅在线程转储文件由 JVM 本身生成时可用

* 线程状态。 可识别以下状态： | 线程状态 | 描述 | | --- | --- | | `可运行` | 线程正在主动运行或已准备好运行 | | `sleeping` | 线程处于睡眠状态（ `Thread.sleep()` ） | | `waiting on condition` | 线程正在等待条件 | | `waiting for monitor entry` | 线程正在等待获取监视器锁 | | `sleeping` | 线程处于睡眠状态（ `Thread.sleep()` ） | | `parking` | 线程已停放（ `LockSupport.park()` ） | | `on object monitor` | 线程正在等待对象监视器 | | `idle` | 事件调度线程处于空闲状态 |

### 线程状态行

线程状态行紧跟在线程页眉行之后，并包含 JVM 指示的线程状态。 可能的状态如下：

|  线程状态  |  描述  |
| --- | --- |
|   `NEW`   |  尚未开始执行的线程  |
|   `RUNNABLE`   |  在 Java 虚拟机中执行的线程  |
|   `BLOCKED`   |  被阻塞并等待监视器锁的线程  |
|   `WAITING`   |  无限期等待另一个线程执行特定操作的线程  |
|   `TIMED_WAITING`   |  在指定等待时间内等待另一个线程执行操作的线程  |
|   `TERMINATED`   |  已完成执行的线程  |

有关线程状态的更多信息，请参阅 [官方 Java 文档](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/lang/Thread.State.html)。

### 堆栈跟踪

堆栈跟踪显示线程的方法调用序列，其特点如下：

* 堆栈跟踪中的每一行都以制表符字符开头。

* 方法调用按从上（最近/被调用的方法）到下（较早/调用方方法）的顺序列出。

* 每一行都遵循以下格式： `at package.class.method(SourceFile:LineNumber)` 。 当 IntelliJ IDEA 识别出源文件时，可以使用它 [导航到源代码](#jump-to-source)。

### 锁信息

如果可用，IntelliJ IDEA 的线程转储文件会提供线程持有的锁的信息，包括：

* 此线程拥有的监视器

* 被此线程阻塞的线程

* 此线程正在等待的监视器

* 包含类和内存地址的锁对象

### Kotlin 协程

可以在 IntelliJ IDEA 的线程转储文件中查看 Kotlin 协程以及 Java 线程。 例如：

```
"coroutine:2" SUSPENDED
    at kotlinx.coroutines.DelayKt.awaitCancellation(Delay.kt:157)
    at NetworkServiceKt.fetchData(NetworkService.kt:15)
    at MainKt$main$1.invokeSuspend(Main.kt:11)
    at kotlin.coroutines.jvm.internal.BaseContinuationImpl.resumeWith(ContinuationImpl.kt:33)

```

协程信息的格式如下：

```
"CoroutineName:id" (state) [dispatcher]
  <coroutine descriptor>
  <stack trace>

```

* 名称和 ID：协程名称后跟其唯一 ID，例如 `coroutine:1`

* 状态：协程的当前状态，例如 `暂停`

* 调度器：有关协程正在使用的调度器的信息，例如 `Dispatchers.IO`

* 堆栈跟踪：协程的堆栈帧

协程可能处于以下状态之一：

|  协程状态  |  描述  |
| --- | --- |
|   `运行中`   |  协程当前正在执行  |
|   `暂停`   |  协程在挂起点处挂起  |
|   `创建`   |  协程已创建但尚未启动  |
|   `未知`   |  无法确定状态  |

