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（确保主进程和子进程环境都可用）
• 在子进程入口函数开头加入调试初始化代码：

此时子进程会暂停，你可在 VSCode 中通过“运行 → 添加配置 → Python: Attach”创建附加配置，设置对应端口后手动附加——但更推荐自动化方式。

使用 launch.json 自动附加子进程（推荐）

VSCode 1.84+ 支持 subProcess: true 选项，配合 debugpy 可实现子进程自动被调试器捕获，无需手动附加或修改业务代码。

• 确保 Python 扩展版本 ≥ 2025.10.0，且已安装 debugpy ≥ 1.6.0
• 在 .vscode/launch.json 中添加配置：

该配置会自动为所有由 multiprocessing、concurrent.futures 或 subprocess 启动的子进程注入调试器，并在 VSCode 中显示为独立的调试会话（可在“运行和调试”面板中切换）。

注意事项与常见问题

• Windows 上 spawn 启动方式必须开启：若用 set_start_method('spawn')，确保主模块受 if __name__ == '__main__': 保护，否则子进程重复执行主逻辑可能引发异常
• 日志与输出混乱：多进程并发打印易交错，建议用 logging 并在 formatter 中加入 %(processName)s 区分来源
• 断点未命中？检查是否在子进程代码中设置了断点，且子进程确实执行到了该行；确认 subProcess: true 已启用且无拼写错误
• 性能开销：启用子进程调试会略微增加启动时间，生产环境切勿开启

基本上就这些。只要配置正确，VSCode 就能像调试单进程一样，在多进程场景下自由设断点、查看变量、单步执行——不需要改架构，也不用切终端。