Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Subprocess debugging not working when --pid and --configure-subProcess are used

Open
#1,536 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
35/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Stale
Tech stack
python
Domain
devtools

Research direction

Reproduce the issue with python -m debugpy --listen 0.0.0.0:5678 --pid 1 --configure-subProcess True against an application that spawns subprocesses, then attach from VS Code. Compare this with configuring debugpy through debugpy.listen(5678) and verify that subprocesses appear in the Call Stack and accept breakpoints.

Written by the indexing model from the issue text.

Description

bug

Before creating a new issue, please check the FAQ to see if your question is answered there.

Environment data

  • debugpy version: 1.8.1 (run import debugpy; print(debugpy.__version__) if uncertain)
  • OS and version: Debian GNU/Linux 11 (bullseye)
  • Python version (& distribution if applicable, e.g. Anaconda): Python 3.8.18
  • Using VS Code or Visual Studio: VS Code

Actual behavior

Debugging session does not recognize subprocesses when debugpy is started using command python -m debugpy --listen 0.0.0.0:5678 --pid 1 --configure-subProcess True
Code running on MainThread works, the issues is with subprocesses.

Debugging sessions work just fine when configuring debugpy from code using debugpy.listen(5678)

Expected behavior

Debugging subprocesses works when launching debugpy using --pid 1 --configure-subProcess True arguments

Steps to reproduce:

  1. Have an app that spawns subprocesses
  2. Inject debugpy using command python -m debugpy --listen 0.0.0.0:5678 --pid 1 --configure-subProcess True
  3. Attach debug session
  4. Observe subprocesses are not available in Call Stack window and breakpoints don't work.
Dominant language
Python
Stars
2.5k
Forks
202
Avg merge
5d 1h
Merged PRs (30d)
1

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from microsoft/debugpy

All issues in microsoft/debugpy

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.