PyCharm Debugger Not Working / Breakpoints Not Hit

How to fix it

Try these in order — the most common fix is first.

1. 1. Switch debugger mode to pydevd

   Copy steps
   1. Settings | Python | Debugger
   2. Set the Debugger mode field to pydevd, or use the selector in the Debug window's upper-right corner
   Did this fix it? Yes No

2. 2. Check basic debug setup

   Copy steps
   1. Set a breakpoint, right-click the file and choose Debug <filename>
   2. Review Settings | Python | Debugger options such as Debug just my code
   Did this fix it? Yes No

Symptoms

Debug starts but breakpoints are ignored, or debugging a remote or special run type fails.

Why it happens

• Remote interpreter (SSH, Docker, Vagrant)
• Attach to Process, Scrapy, Sphinx doctest, remote Jupyter, non-server manage.py tasks
• Debugger mode mismatch

This guide also covers

• pycharm debugger not working
• pycharm breakpoint not hit
• pycharm debug not stopping at breakpoint

Other PyCharm errors

• PyCharm Invalid Python Interpreter / Invalid Environment
• PyCharm No Python Interpreter Configured for the Project
• PyCharm Unresolved Reference: Installed Package Not Recognized
• PyCharm Cannot Install or Find a Package
• PyCharm Conda Executable Not Found / Conda Environment Not Detected
• PyCharm Indexing Takes Forever / Stuck on Analyzing Project
• PyCharm Low Memory Warning: How to Increase the Heap Size
• PyCharm Invalidate Caches / Restart: When and How