PyCharm 2026.1 Help

调试器

使用此页面配置 Python 调试选项。

项目

描述

调试时自动附加到子进程

选中此复选框后,PyCharm 将自动附加被调试进程的所有子进程。 因此,如果父进程具有子进程,其断点将始终生效。

收集运行时类型信息以用于代码洞察

选中此复选框后,将在调试期间保留函数调用的类型,并将其传递给类型检查器。 有关更多信息,请参见 通过文档字符串指定类型

清除缓存

点击此按钮可移除在运行时收集的参数类型信息。

Gevent 兼容

选中此复选框后,调试器将与使用 Gevent monkey patch 的代码兼容。 您也可以通过设置 GEVENT_SUPPORT=True 环境变量来启用 Gevent 支持。

测试失败时进入调试器

选中此复选框后,PyCharm 将在每个失败的测试处暂停,并显示失败原因。 有关更多信息,请参见 调试失败的测试

与 PyQt 兼容

如果在解释器上安装了 PyQt,但未在应用程序代码中导入,可能会出现某些导入错误。 取消选择此选项可修复这些错误。

如果您的解释器上安装了多个与 PyQt 兼容的后端,您必须在列表中选择 PyQtPySide2 后端。 默认启用 自动 选项,这意味着将使用首先找到的后端。

对于 附加到进程 ,显示名称包含以下内容的进程

此字段中指定的字符串模式将用于在 附加到进程 列表中显示进程。 默认模式是 "python"。

调试器评估响应超时

使用此选项可设置调试期间等待评估响应的最长时间。

  • Windows 上,已编译的 Cython 扩展随 PyCharm 一起打包提供。

  • LinuxmacOS 上,应通过以下两种方式之一手动编译 Cython 扩展:

    • 在首次启动调试器后,点击警告中出现的链接。

    • 在终端中手动运行警告中的命令。 每个 Python 解释器版本都应分别编译一个 Cython 扩展。

    如果不想使用 Cython 扩展,应传递环境变量 PYDEVD_USE_CYTHON=NO

2026年 3月 24日