PyCharm 2026.1 Help

Debugger

Use this page to configure Python debug options.

Item

Description

Attach to subprocess automatically while debugging

If this checkbox is selected, PyCharm will automatically attach all subprocesses of the process being debugged. Thus, if the parent process has subprocesses, their breakpoints will always work.

Collect runtime types information for code insight

If this checkbox is selected, the types of function calls are preserved during debugging and passed to the type checker. For more information, refer to Specify types with docstrings.

Clear caches

Click this button to remove information about the types of arguments collected at run time.

Gevent compatible

If this checkbox is selected, the debugger will be compatible with the Gevent-monkeypatched code. You can also enable the Gevent support by setting GEVENT_SUPPORT=True environment variable.

Drop into debugger on failed tests

If this checkbox is selected, PyCharm will stop on every failed test and show the reason for the failure. For more information, refer to Debug failed tests.

PyQt compatible

If PyQt is installed on the interpreter but is not imported in the application code, some import errors may occur. Deselect this option to fix the errors.

If you have multiple PyQt compatible backends installed on your interpreter, you have to select the PyQt or PySide2 backend from the list. By default, the Auto option is enabled, which means that the backend first found will be used.

For Attach to Process show processes with names containing

A string pattern specified in this field will be used to show processes in the Attach to Process list. The default pattern is "python".

Debugger evaluation response timeout

Use this option to set the maximum time to wait for an evaluation response during debugging.

Debugger mode

Use this option to select the debugger mode PyCharm will use:

  • pydevd – the core debugger engine that runs inside Python.

  • debugpy – connects PyCharm to a running Python program for debugging. Enables breakpoints, stepping, variable inspection and remote debugging from the editor. It is available only for Python 3.9 and later, and for local development.

  • On Windows the compiled Cython extensions are bundled with PyCharm.

  • On Linux and macOS, Cython extensions should be compiled manually in one of two possible ways:

    • by clicking the link that appears in the warning after the first debugger launch.

    • by running the command from the warning manually in the terminal. A separate Cython extension should be compiled for each version of Python interpreter.

    If someone does not want to use Cython extensions, the environment variable PYDEVD_USE_CYTHON=NO should be passed.

26 March 2026