llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

线程转储

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

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

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

从 IntelliJ IDEA 捕获线程转储

  1. 从 IntelliJ IDEA 运行程序时:在 运行 工具窗口的工具栏上,点击 线程转储。

    运行工具窗口工具栏上的转储线程按钮
  2. 从 IntelliJ IDEA 调试程序时:在 调试 工具窗口的工具栏上,点击 更多更多 ,然后选择 获取线程转储文件。

    调试工具窗口工具栏上的“更多”按钮
  3. 对于本地运行的任何 Java/Kotlin 进程:在 分析器 工具窗口的 首页 选项卡上,点击要为其创建线程转储文件的进程。 选择 获取线程转储文件。

    右键点击 Profiler 工具窗口中的进程时,会打开一个菜单

打开外部线程转储文件

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

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

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

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

图标

描述

运行中/活动 – 默认状态,线程在此状态下正在主动执行代码

(对于 Kotlin 协程)运行中 – 协程正在主动执行代码

休眠 – 在线程处于 Thread.sleep ,或者被挂起或正在等待条件时发生

载体线程 – 当前正在执行虚拟线程的平台线程,或处于 已创建/未知 状态的协程

等待 – 在线程正在等待对象监视器,或协程被挂起时发生

套接字 – 在线程正在执行网络 I/O 时发生

I/O – 在线程正在执行非网络 I/O 操作时发生

、

EDT(事件调度线程)– Swing 应用程序中的 UI 线程。 表示空闲 EDT, 表示活动状态。

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

线程转储文件中指示虚拟线程和守护线程的叠加标记

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

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

跳转到源

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

    线程转储中的超链接

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

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

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

    线程转储文件查看器中的“导出到文本文件”按钮
  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 文档。

堆栈跟踪

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

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

  • 方法调用按从上(最近/被调用的方法)到下(较早/调用方方法)的顺序列出。

  • 每一行都遵循以下格式: at package.class.method(SourceFile:LineNumber)。 当 IntelliJ IDEA 识别出源文件时,可以使用它 导航到源代码。

锁信息

如果可用,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

  • 堆栈跟踪:协程的堆栈帧

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

协程状态

描述

运行中

协程当前正在执行

暂停

协程在挂起点处挂起

创建

协程已创建但尚未启动

未知

无法确定状态

2026年 11月 3日