PyCharm 2018.1 Help

Breakpoints

Run | View Breakpoints
Ctrl+Shift+F8
debug view breakpoints

Breakpoint options

Use the toolbar buttons to add or remove breakpoints, and group them by package, file or class.

The options depend on the selected breakpoint type:

OptionDescriptionTypes of breakpoints
EnabledSelect this option to enable breakpoints. If a breakpoint is disabled, PyCharm will skip it during the debugging process.
SuspendSelect this option to enable the suspend policy for a breakpoint.

Select one of the options to specify the way a program is paused when a breakpoint is reached. If you work with JavaScript breakpoints, you only need to specify whether you want to suspend the program execution when a breakpoint is hit.

If this option is deselected, no threads are suspended.

  • All: when a breakpoint is hit, all threads are suspended.
  • Thread: when a breakpoint is hit, the thread containing this breakpoint is suspended.
  • Make default: click if you want the suspend policy for the selected breakpoint to be used as the default one (only available if the Thread option is selected).
  • Two breakpoints are set at the different methods of a class, and their suspend policy is set to All.
  • When one of the breakpoints is hit, some stepping actions are performed.
  • If at the time of stepping another thread hits the second breakpoint, PyCharm will not stop there.
Python line breakpoints
Condition Select this checkbox and specify a condition for hitting the breakpoint.

A condition is a Boolean expression.

This expression should be valid at the line where the breakpoint is set, and is evaluated every time the breakpoint is reached. If the evaluation result is true, user-selected actions are performed.

If the result is false, the breakpoint does not produce any effect. If the Debugger cannot evaluate the expression, it displays the Condition evaluation error message. You can select whether you would like to stop at this breakpoint or ignore it.

All types
Log to console Select if you want to log the following events to console:
  • "Breakpoint hit" message: a log message will be displayed in the console output when this breakpoint is hit.
  • Stacktrace: this breakpoint's stacktrace will be print to console when it's hit. This is useful if you want to check which paths have lead to the given point without stopping the program's execution.
All types
Evaluate and logSelect this checkbox if you wish to evaluate a certain expression at this breakpoint and to export the result to the console output. Press Shift+Enter to open the multiline editor. Line breakpoints
Remove once hitSelect if you want the breakpoint to be deleted after it was hit.All types
Disable until breakpoint is hitFrom the drop-down list, select the breakpoint in question. The None option corresponds to the always enabled breakpoint.

Besides that, you can also choose the behavior of this breakpoint, when the selected one is hit:

  • Disable again
  • Leave enabled
All types
Activation policy
On terminationThe Debugger stops when the process terminates with this exception.Python exception breakpoints
On raise If this option is selected, the Debugger stops on throwing an exception. So doing, the Debugger stops only on the first place where the exception has been thrown. Python exception breakpoints
Ignore library filesIf this checkbox is selected, the debugger does not stop at the exceptions thrown inside libraries.
If this checkbox is not selected, the debugger stops at the location in a library file, where the exception is thrown.
Python exception breakpoints

Context menu commands

CommandDescription
Move to groupPoint to this command to move the selected breakpoint to a new group, to one of the existing groups (<group name>), or out of a group (<no group>).
Edit descriptionChoose this command to enter or change description of a breakpoint.

Speed search of a breakpoint

To find a particular breakpoint

  • Start typing address or description of the target breakpoint.
    py breakpoint search

    PyCharm highlights the line with the matching address or description.

Last modified: 23 July 2018

See Also