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 可实现子进程自动被调试器捕获，无需手动附加或修改业务代码。
立即学习“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 就能像调试单进程一样，在多进程场景下自由设断点、查看变量、单步执行——不需要改架构，也不用切终端。
