Python子进程启动时断点调试遇错，如何用VSCode附加调试？

问题描述 #

• 需求：在复杂环境中让Python子进程启动时暂停，类似JavaScript中的debugger;，以便后续用VSCode附加调试。
• 尝试breakpoint()后的错误：

...
File "/usr/lib/python3.9/cmd.py", line 126, in cmdloop
line = input(self.prompt)
AttributeError: 'StringStream' object has no attribute 'readline'
推测是子进程无可用的标准输入导致。

• 补充尝试：用-m pdb启动子进程能暂停，但VSCode附加后无法恢复执行，VSCode使用pydevd调试框架，怀疑pdb仍在等待交互输入。

解决方案 #

方法1：直接用pydevd触发暂停（适配VSCode） #

在子进程代码开头加入以下代码替代breakpoint()，利用VSCode自带的pydevd框架实现无输入依赖的暂停：

import pydevd
# suspend=True表示启动即暂停，timeout=0表示无限等待调试器附加
pydevd.settrace(suspend=True, trace_only_current_thread=False, timeout=0)

子进程启动后会立刻挂起，直到VSCode附加调试器，不会依赖标准输入，彻底规避StringStream错误。

方法2：修复pdb的标准输入问题（可选） #

如果坚持使用breakpoint()或pdb.set_trace()，需要确保子进程能获取可交互的标准输入：

• 启动子进程时显式绑定终端输入：比如在父进程中用subprocess启动时，设置stdin=subprocess.PIPE或者直接继承父进程的终端输入（stdin=None）
• Linux环境下可配合start_new_session=True强制分配终端，避免输入重定向导致的问题
  不过这种方法在复杂环境中兼容性较差，不如方法1适配VSCode直接。

方法3：环境变量控制断点（灵活切换） #

通过环境变量控制是否触发启动暂停，无需硬编码修改代码：

import os
if os.environ.get("PYTHON_DEBUG_AT_START") == "1":
    import pydevd
    pydevd.settrace(suspend=True, timeout=0)

启动子进程前设置环境变量PYTHON_DEBUG_AT_START=1即可触发暂停，不需要调试时去掉该变量即可正常运行。

内容的提问来源于stack exchange，提问作者vilal32