debugpy/TROUBLESHOOTING.md

Troubleshooting

If you're having trouble with debugpy, check below for information which may help. If something isn't covered here, please file an issue with the information given in Filing an issue.

Known Issues

There are a few known issues in the current version of the debugger:

Breakpoints not set

If you receive an error saying breakpoint not set, then look at your path mappings in launch.json. See Meta-Issue #2976 for more details.

Debugging Library Files

If you want to debug library files, you have to disable justMyCode in launch.json. Previously this setting was debugStdLib. For example:

{
    "name": "Terminal",
    "type": "python",
    "request": "launch",
    "pythonPath": "${config:python.pythonPath}",
    "program": "${file}",
    "console": "integratedTerminal",
    "justMyCode": false
},

Filing an issue

When filing an issue, make sure you do the following:

• Check existing issues for the same problem (also see the "Known Issues" section above for widespread problems).
• Follow instructions in this template for filing a bug report.
• Include any debugger logs that you may have. See here for instructions on how to enable logging.