VSCode调试PyQt5：信号触发的槽函数异常无法中断

问题背景 #

在VSCode调试PyQt5应用时，普通代码断点可正常触发，但Qt信号触发的槽函数中抛出未捕获异常时，调试器不会触发“User Uncaught Exceptions”断点，反而直接终止程序。仅在异常行手动设置断点，或开启“Raised Exceptions”断点时，调试器才会在异常处中断。

原因解析 #

这是Qt事件循环的特性导致的：Qt的事件分发机制会自动捕获槽函数中抛出的所有异常，这些异常不会向上传播到Python的全局异常处理链。对VSCode调试器而言，这类异常属于“已被外部（Qt）捕获处理”的范畴，因此“User Uncaught Exceptions”断点无法识别并触发。

解决方案 #

方案1：自定义Qt全局异常钩子 #

通过重写Python的全局异常钩子，让Qt捕获的异常重新抛出，从而被调试器的“User Uncaught Exceptions”断点识别。示例代码如下：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton

def qt_exception_hook(type_, value, traceback):
    # 保留系统默认的异常打印逻辑
    sys.__excepthook__(type_, value, traceback)
    # 重新抛出异常，触发调试器的未捕获异常断点
    raise value

class Window(QMainWindow):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.b = QPushButton("Button", self)
        self.b.setCheckable(True)
        self.b.toggle()
        self.b.clicked.connect(lambda: self.do_on_click(self.b))
        self.setWindowTitle("Button demo")

    def do_on_click(self, b):
        raise(Exception("This is to provocate the debugger mal-function."))
        print("Clicked")

if __name__ == "__main__":
    # 替换全局异常钩子
    sys.excepthook = qt_exception_hook
    app = QApplication(sys.argv)
    window = Window()
    window.show()
    sys.exit(app.exec_())

设置后，槽函数中的未捕获异常会被重新抛出，此时“User Uncaught Exceptions”断点就能正常触发。

方案2：优化“Raised Exceptions”断点配置 #

保持开启“Raised Exceptions”断点，同时在.vscode/launch.json中启用justMyCode选项，过滤掉Qt库内部的异常触发：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "justMyCode": true
        }
    ]
}

该方案无需修改代码，通过调试配置过滤第三方库的异常，仅在你的代码抛出异常时中断。

额外说明 #

debugpy.debug_this_thread()无效的原因是：问题根源是异常被Qt捕获，而非线程未被调试器跟踪，因此该方法无法解决此问题。

内容的提问来源于stack exchange，提问作者Jerome