在VS Code中调试Python多线程或多进程应用

P粉986688829

发布： 2025-12-02 20:44:02

原创

227人浏览过

答案：通过配置launch.json并使用debugpy.listen()，可在VS Code中调试Python多线程和多进程应用。1. 多线程调试需设置"justMyCode": false以捕获子线程断点；2. 多进程调试需在子进程入口调用debugpy.listen()和wait_for_client()，并用独立的Attach配置连接指定端口；3. 建议为子进程动态分配端口避免冲突，并使用logging或sleep辅助调试。

在vs code中调试python多线程或多进程应用

在VS Code中调试Python多线程或多进程应用确实比单线程程序更复杂，因为默认的调试器（如debugpy）通常只附加到主进程或主线程。但通过合理配置和使用一些技巧，你可以有效调试这类并发程序。

启用多线程调试

Python的threading模块创建的子线程默认可以被debugpy捕获，只要你在启动调试时允许调试器跟踪子线程。

在launch.json中设置以下参数：

{
    "name": "Python: Multi-threaded",
    "type": "python",
    "request": "launch",
    "program": "${file}",
    "console": "integratedTerminal",
    "justMyCode": false,
    "stopOnEntry": false
}

登录后复制

关键点：

立即学习“Python免费学习笔记（深入）”；

"justMyCode": false 确保调试器能进入第三方库或系统调用，有助于查看线程内部行为。
在代码中正常使用threading.Thread即可，断点在子线程函数中依然会触发。
确保没有意外地阻塞了主线程，否则调试器可能提前退出。

调试多进程应用（multiprocessing）

使用multiprocessing时，每个新进程是独立的，因此默认情况下调试器无法自动附加到子进程。你需要手动在子进程中启动调试器。

解决方法是在子进程的入口函数中显式调用debugpy的监听功能。

示例代码：

无涯·问知

无涯·问知，是一款基于星环大模型底座，结合个人知识库、企业知识库、法律法规、财经等多种知识源的企业级垂直领域问答产品

153

查看详情

import multiprocessing as mp
import debugpy
<p>def worker_function():</p><h1>子进程开始后等待调试器连接</h1><pre class='brush:php;toolbar:false;'>debugpy.listen(5678)
print("Worker process waiting for debugger to attach...")
debugpy.wait_for_client()  # 阻塞直到客户端连接
print("Debugger attached, continuing...")

# 此处设置你的断点
x = 10
y = x * 2
print(f"Result: {y}")

登录后复制

if name == "main":

主进程也启动调试监听（可选）

debugpy.listen(5678)
p = mp.Process(target=worker_function)
p.start()
p.join()

登录后复制

然后在launch.json中添加一个“Attach”配置：

{
    "name": "Python: Attach to Subprocess",
    "type": "python",
    "request": "attach",
    "connect": {
        "host": "localhost",
        "port": 5678
    },
    "justMyCode": false
}

登录后复制

运行主程序后，手动启动“Attach”配置去连接子进程。注意端口不要冲突，多个子进程需使用不同端口。