VSCode 调试 Python 多进程需启用子进程自动调试:升级 Python 扩展和 debugpy 后,在 launch.json 中配置 "subProcess": true,即可自动捕获 multiprocessing 等启动的子进程并支持断点、变量查看与单步执行。

VSCode 调试 Python 多进程应用默认不支持子进程断点,因为 Python 的 multiprocessing 模块会启动全新解释器进程,而 VSCode 的调试器只附着在主进程上。要让子进程也能被调试,核心思路是:让每个子进程主动连接到 VSCode 的调试服务(即启用“附加模式”调试)。
启用调试器自动附加子进程
最简单有效的方式是使用 debugpy(VSCode Python 扩展底层依赖的调试器),并在子进程中显式调用 debugpy.listen() 和 debugpy.wait_for_client()。注意:需确保所有进程使用同一调试端口或分配唯一端口(推荐后者避免冲突)。
- 安装 debugpy:
pip install debugpy(确保主进程和子进程环境都可用) - 在子进程入口函数开头加入调试初始化代码:
debugpy.listen(5678 + os.getpid() % 100) # 避免端口冲突,例如用 PID 偏移
debugpy.wait_for_client() # 阻塞等待 VSCode 附加
此时子进程会暂停,你可在 VSCode 中通过“运行 → 添加配置 → Python: Attach”创建附加配置,设置对应端口后手动附加——但更推荐自动化方式。
使用 launch.json 自动附加子进程(推荐)
VSCode 1.84+ 支持 subProcess: true 选项,配合 debugpy 可实现子进程自动被调试器捕获,无需手动附加或修改业务代码。
注意:需要在本地调试我们的网站的必须安装配置IIS,不可以使用ASP调试工具.exe或小旋风asp或APMServ等这类工具调试,因为这类简易的IIS替代工具,去掉了很多功能,有些语句是不支持的。 【程序】ASP 【数据库】ACCESS (只要支持ASP的空间均自带此数据库) 【前台】全部生成.html静态页面 本程序专为企业网站进行打造,三大特色无与伦比: ☆全后台操作☆前台所有内容均可以后台
立即学习“Python免费学习笔记(深入)”;
- 确保 Python 扩展版本 ≥ 2023.10.0,且已安装 debugpy ≥ 1.6.0
- 在
.vscode/launch.json中添加配置:
"name": "Python: Multi-Process",
"type": "python",
"request": "launch",
"module": "your_main_module",
"console": "integratedTerminal",
"subProcess": true // 关键:启用子进程自动调试
}
该配置会自动为所有由 multiprocessing、concurrent.futures 或 subprocess 启动的子进程注入调试器,并在 VSCode 中显示为独立的调试会话(可在“运行和调试”面板中切换)。
注意事项与常见问题
-
Windows 上 spawn 启动方式必须开启:若用
set_start_method('spawn'),确保主模块受if __name__ == '__main__':保护,否则子进程重复执行主逻辑可能引发异常 -
日志与输出混乱:多进程并发打印易交错,建议用
logging并在 formatter 中加入%(processName)s区分来源 -
断点未命中?检查是否在子进程代码中设置了断点,且子进程确实执行到了该行;确认
subProcess: true已启用且无拼写错误 - 性能开销:启用子进程调试会略微增加启动时间,生产环境切勿开启
基本上就这些。只要配置正确,VSCode 就能像调试单进程一样,在多进程场景下自由设断点、查看变量、单步执行——不需要改架构,也不用切终端。









