VSCode调试器为何忽略已勾选设置的未捕获异常？

问题回顾 #

运行以下Pandas代码时，抛出KeyError: 'w'但VSCode调试器未在Pandas源码的raise语句处停止，仅输出错误信息：

import pandas as pd
index = pd.Index([1,2,3,4]).get_loc('w')

已配置：

• 勾选「未捕获的异常」「用户未捕获的异常」，未勾选「已引发的异常」
• launch.json中设置"justMyCode": false

自定义嵌套try-except再raise的测试代码能正常触发调试器停止，但Pandas源码中的相同逻辑无法触发。

可行解决方案 #

1. 手动在Pandas源码对应行添加断点 #

找到本地Pandas安装目录下的core/indexes/base.py文件，定位到以下代码块的raise行：

try:
    return self._engine.get_loc(casted_key)
except KeyError as err:
    raise KeyError(key) from err  # 在此行添加断点

直接点击行号左侧添加断点，由于已开启justMyCode: false，调试器运行到此处时会自动停止。

2. 创建精准的条件异常断点 #

通过条件过滤避免勾选「已引发的异常」带来的大量无关停止：

1. 打开调试面板（快捷键Ctrl+Shift+D）
2. 点击面板顶部的「添加异常断点」（加号按钮），选择「Python: Exception Breakpoint」
3. 输入框中填写KeyError
4. 右键点击刚创建的异常断点，选择「编辑条件」，输入以下规则：

   'w' in str($exception) and 'pandas/core/indexes/base.py' in $exception.__traceback__.tb_frame.f_code.co_filename
   

   该条件会让调试器仅在Pandas的base.py文件中抛出包含'w'的KeyError时停止。

3. 配置launch.json的异常过滤规则 #

在launch.json中添加精细化的异常触发配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "justMyCode": false,
            "exceptionBreakpointFilters": [
                {
                    "filter": "uncaught",
                    "default": true
                },
                {
                    "filter": "userUnhandled",
                    "default": true
                },
                {
                    "filter": "raised",
                    "default": false,
                    "condition": "'w' in str($exception) and 'pandas/core/indexes/base.py' in $exception.__traceback__.tb_frame.f_code.co_filename"
                }
            ]
        }
    ]
}

此配置仅在符合条件的KeyError触发时，才会激活「已引发的异常」断点，避免无关干扰。

问题原因推测 #

Pandas内部的异常传播路径中，调试器默认的「未捕获异常」规则未将其识别为未捕获（可能存在顶层隐式处理逻辑），但通过精准的条件断点或手动断点，可绕过识别问题，强制在目标位置停止。

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