如何配置VSCode实现类似Winpdb的Python多线程调试功能

VSCode 官方Python调试组件debugpy原生支持你需要的全部调试特性，无需安装第三方插件，仅需调整少量配置即可。

基础调试配置 #

打开项目后进入左侧「运行和调试」面板，选择创建launch.json文件，环境选Python，模板选「Python文件」，将配置内容替换为以下内容：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: 多线程/多进程调试",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "justMyCode": false,
            "subProcess": true,
            "redirectOutput": true
        }
    ]
}

关键配置项说明：

• justMyCode: false：必须关闭，否则调试器会跳过标准库、依赖库的线程调度逻辑，无法展示完整线程调用栈
• subProcess: true：你的示例代码用了ProcessPoolExecutor创建进程池，开启该选项后调试器会自动附加到所有子进程，否则只能看到主进程内的线程
• 其余参数保持默认即可，debugpy默认会自动捕获所有运行中新建的用户线程，无需额外配置线程追踪参数

线程/进程状态查看操作 #

按F5启动调试后，左侧「调用栈」面板会自动分层展示所有执行单元：

• 面板按进程分组，每个进程节点下展开即可看到该进程内的所有线程，包括主线程、你手动创建的fib_handler客户端处理线程、进程池工作线程
• 点击任意线程/进程条目，编辑器会自动跳转到对应执行单元当前停留的代码行，「变量」面板同步切换展示该作用域下的所有变量值，可随时切换查看主线程的socket监听状态、各客户端线程的请求处理进度、进程池内fib计算的运行状态
• 每个线程条目旁会标注当前状态：运行中、暂停、阻塞在IO/锁等待

单线程独立控制配置 #

默认状态下调试的继续、单步操作是全局生效的，要实现和Winpdb一致的单线程独立控制，只需要一步设置：
在调用栈面板空白处右键，勾选菜单中的单线程调试选项即可。

开启单线程调试后，所有执行操作（单步跳过、单步进入、继续、暂停）仅作用于你当前选中的线程，其余线程会保持原有运行/暂停状态不受影响。你可以单独控制某一个客户端线程逐步执行排查问题，同时让主线程、其他客户端线程、进程池工作进程正常运行。
调试控制台的执行上下文默认跟随调用栈的选中项，选中哪个线程，控制台输入的表达式就会在对应线程的作用域下求值，可独立查询、修改不同线程的变量，不会干扰其他执行单元。

针对你提供的Fib服务示例的调试提示 #

你贴的示例代码同时使用了线程处理客户端连接、进程池执行计算逻辑，调试时注意两个细节：

• 代码中客户端处理线程是daemon线程，只有当客户端发起连接、线程被创建后，对应线程条目才会出现在调用栈面板中，无连接时面板仅展示主线程和4个进程池工作进程
• 如果需要固定观察某几个跨线程的变量，不需要反复切换线程，右键变量选择「添加到监视」即可，监视面板的内容不会随线程切换消失
• 如果断点命中后看不到完整调用栈，优先检查justMyCode配置是否为false，重启调试即可生效

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