VS Code调试器下sys.excepthook无法正常处理Python自定义异常

当你开发Python库并使用自定义异常时，通过sys.excepthook可以在非调试模式下隐藏库内的raise栈帧，但VS Code调试器（基于debugpy）会接管异常处理，导致原有方法失效。以下是几个可行的解决办法：

方法1：给自定义异常添加__tracebackhide__属性 #

Python调试器（包括debugpy）会识别这个特殊属性，自动隐藏对应的栈帧。只需在自定义异常类中添加该属性即可：

class MyError(Exception):
    __tracebackhide__ = True

如果需要更灵活的控制，也可以在抛出异常时临时设置：

# 库内代码
def some_function():
    # 逻辑处理
    err = MyError("自定义错误信息")
    err.__tracebackhide__ = True
    raise err

方法2：配置VS Code调试器跳过库文件 #

在项目的.vscode/launch.json中添加skipFiles配置，指定需要跳过的库文件路径，调试器就不会在回溯中显示这些文件的栈帧：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: 当前文件",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "skipFiles": [
                "${workspaceFolder}/mylibrary/**/*.py"  // 替换为你的库实际路径
            ]
        }
    ]
}

方法3：手动修剪异常回溯 #

通过Python的内部API手动修改异常的回溯对象，去掉库内的栈帧。这种方法依赖Python内部实现，可能存在版本兼容性问题，但可以精准控制：

import sys

class MyError(Exception):
    def __init__(self, message):
        super().__init__(message)
        # 遍历回溯链，跳过库内的栈帧
        tb = self.__traceback__
        while tb:
            frame_path = tb.tb_frame.f_code.co_filename
            # 判断当前帧是否属于库文件，根据实际路径调整判断逻辑
            if "/mylibrary/" in frame_path:
                tb = tb.tb_next
            else:
                break
        self.__traceback__ = tb

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