Python中如何定位行内错误的精确触发位置？

问题背景 #

Python 3.8及更早版本中，当一行代码包含多个链式索引/属性访问操作时，报错只会返回错误所在行号，无法定位到具体哪个操作触发了错误。比如多层字典访问场景下，没法直接确定是哪一步的对象类型不符合预期——尤其当xs、ys、zs这类变量是耗时计算的结果时，排查成本很高。

示例代码 #

xs = []
ys = {"item": xs}
zs = {"item": ys}
print(zs['item']['item']['item'])

默认报错信息 #

Traceback (most recent call last):
  File "p.py", line 4, in <module>
    print(zs['item']['item']['item'])
TypeError: list indices must be integers or slices, not str

这个报错只能定位到第4行，但无法明确是哪个['item']触发了类型错误。

期望的精确报错效果 #

Traceback (most recent call last):
  File "p.py", line 4, in <module>
    print(zs['item']['item']['item'])
                            ^-------
TypeError: list indices must be integers or slices, not str

解决方案 #

针对Python 3.8.16版本，有三种可行方案：

• 升级Python版本：Python 3.10及以上版本原生支持PEP 657定义的精确错误位置标注，升级后无需额外配置就能得到类似期望效果的报错。
• 拆分链式访问代码：把一行的链式操作拆成多行单独赋值，报错会直接指向具体出错的行，快速定位问题：

  xs = []
  ys = {"item": xs}
  zs = {"item": ys}
  step1 = zs['item']
  step2 = step1['item']
  step3 = step2['item']  # 报错会指向这一行，明确step2是列表，不能用字符串索引
  print(step3)
  

• 使用第三方增强库：安装better-exceptions库增强错误输出：
  1. 执行安装命令：pip install better-exceptions
  2. 在代码开头添加配置：

     import better_exceptions
     better_exceptions.hook()
     

     运行代码后，报错会显示更详细的上下文和精确位置标记。

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