# 调试 Kotlin 协程

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

> **TL;DR**
> 必需插件：   Kotlin  （捆绑）

虽然协同程序特别适合异步编程，但由于异步流程带来的挑战，仍然有出错的可能，而且这些错误可能很难查明。

在调试 Kotlin 代码时，IntelliJ IDEA 允许您暂停执行并诊断协程中的代码可能存在的问题。 即使协程此刻没有运行，调试信息也可用。

在 [Kotlin 文档](https://kotlinlang.org/docs/coroutines-debugging.html)中了解详情。

## 检查协程

Procedure:

1. 在协程代码中或附近设置一个 [断点](using-breakpoints.html)。

2. 以调试模式启动应用程序。

3. 等待应用程序到达断点。

4. 在   调试  工具窗口中，选择   协程  选项卡，该选项卡位于   布局设置  中。

该视图按调度器对协程进行分组。 展开调度器节点以查看其协程。

![在 Coroutines 选项卡中按调度器分组的协程](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kotlin_debug_coroutines_list.png)

对于每个协程，IntelliJ IDEA 都会显示其当前状态：

* 创建 ：协程已创建，但未运行。

* 运行中 ：协程当前正在执行。

* 暂停 ：协程已暂停，当前未在线程上执行。

在适用情况下，该视图还会显示协程正在执行所在的线程信息。

## 检查协程

在   协程  选项卡中，可以看到完整的协程创建堆栈，以及协程内的调用堆栈。 堆栈包含所有带有变量值的帧，即使是在标准调试期间会丢失的帧。

![协程创建栈](https://resources.jetbrains.com.cn/help/img/idea/2026.3/更新变量](examining-suspended-program.html#variables)主题。

![协程的 Variables 选项卡](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kotlin_debug_coroutines_context.png)

如果您对 Kotlin 类中的调用不感兴趣，可以通过点击   在库中隐藏帧   隐藏它们，此选项位于   帧   选项卡的右上角。

![隐藏 Kotlin 类中的调用](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kotlin_debug_coroutines_frames_f.png)

> **Tip:**
> 检查协程的内部操作时，您还可以使用其他分析工具，例如监视和任意表达式求值。

## 捕获线程和协程转储文件

如果需要包含每个协程状态及其堆栈的报告，请使用 [线程转储文件](thread-dumps.html)。

IntelliJ IDEA 的线程转储文件可以包括:

* Java 平台线程

* 虚拟线程

* 检测到的 Kotlin 协程及其堆栈

Procedure: 获取协程转储文件

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

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

