在VSCode中调试Python多进程应用

VSCode 调试 Python 多进程需启用子进程自动调试：升级 Python 扩展和 debugpy 后，在 launch.json 中配置 "subProcess": true，即可自动捕获 multiprocessing 等启动的子进程并支持断点、变量查看与单步执行。 VSCode 调试 Python 多进程应用默认不支持子进程断点，因为 Python 的 模块会启动全新解释器进程，而 VSCode 的调试器只附着在主进程上。要让子进程也能被调试，核心思路是：让每个子进程主动连接到 VSCode 的调试服务（即启用“附加模式”调试）。 启用调试器自动附加子进程 最简单有效的方式是使用 （VSCode Python 扩展底层依赖的调试器），并在子进程中显式调用 和 。注意：需确保所有进程使用同一调试端口或分配唯一端口（推荐后者避免冲突）。 安装 debugpy： （确保主进程和子进程环境都可用） 在子进程入口函数开头加入调试初始化代码： import debugpydebugpy.listen(5678 + os.getpid() % 100) # 避免端口冲突，例如用 PID 偏移debugpy.wait_for_client() # 阻塞等待 VSCode 附加 此时子进程会暂停，你可在 VSCode 中通过“运行 → 添加配置 → Python: Attach”创建附加配置，设置对应端口后手动附加——但更推荐自动化方式。 使用 launch. js on 自动附加子进程（推荐） VSCode 1.84+ 支持 选项，配合 可实现子进程自动被调试器捕获，无需手动附加或修改业务代码。 Trae win Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统（64位）。国内开发者可直接访问 Trae 中文官网（trae.cn 或 trae.com.cn），一键下载官方正版 .exe 安装包，享受国内直连的高速稳定体验。安装过程极其简便，双击即可运行，并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型，让你开箱即用，轻松开启高效的 AI 智能编程之旅。 下载 立即学习 “ Python免费学习笔记（深入） ”； 确保 Python 扩展版本 ≥ 2023.10.0，且已安装 debugpy ≥ 1.6.0 在 中添加配置： {"name": "Python: Multi-Process","type": "python","request": "launch","module": "your_main_module","console": "integratedTerminal","subProcess": true // 关键：启用子进程自动调试} 该配置会自动为所有由 、 或 启动的子进程注入调试器，并在 VSCode 中显示为独立的调试会话（可在“运行和调试”面板中切换）。 注意事项与 常见问题 Windows 上 spawn 启动方式必须开启 ：若用 ，确保主模块受 保护，否则子进程重复执行主逻辑可能引发异常 日志与输出混乱 ：多进程并发打印易交错，建议用 并在 formatter 中加入 区分来源 断点未命中？ 检查是否在子进程代码中设置了断点，且子进程确实执行到了该行；确认 已启用且无拼写错误 性能开销 ：启用子进程调试会略微增加启动时间，生产环境切勿开启 基本上就这些。只要配置正确，VSCode 就能像调试单进程一样，在多进程场景下自由设断点、查看变量、单步执行——不需要改架构，也不用切终端。