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

IntelliJ IDEA 2026.3 Help

调试 Kotlin 协程

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

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

在 Kotlin 文档中了解详情。

检查协程

  1. 在协程代码中或附近设置一个 断点。

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

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

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

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

在 Coroutines 选项卡中按调度器分组的协程

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

  • 创建 :协程已创建,但未运行。

  • 运行中 :协程当前正在执行。

  • 暂停 :协程已暂停,当前未在线程上执行。

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

检查协程

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

协程创建栈

调试协程时,您可以使用 变量 选项卡的所有标准功能。 有关使用 变量 选项卡的更多信息,请参阅 检查/更新变量 主题。

协程的 Variables 选项卡

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

隐藏 Kotlin 类中的调用

捕获线程和协程转储文件

如果需要包含每个协程状态及其堆栈的报告,请使用 线程转储文件。

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

  • Java 平台线程

  • 虚拟线程

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

获取协程转储文件

  • 在 调试 工具窗口的工具栏上,点击 更多更多 ,然后选择 获取线程转储文件。

调试工具窗口工具栏上的“更多”按钮
2026年 11月 3日