Pandas脚本报错仅指向库代码，如何让回溯显示自有代码行？

问题原因 #

这是Pandas的默认行为，和Python解释器无关。为了简化错误输出，Pandas会自动裁剪回溯栈，只保留库内部的调用帧，把触发错误的用户代码行隐藏了。比如你写错列名时，df['Regristation']会调用Pandas底层的列访问逻辑，错误在库内部抛出，Pandas默认的错误处理会过滤掉上层的用户代码栈，导致你看不到自己的代码行。

解决办法 #

1. 关闭Pandas的回溯裁剪 #

在脚本开头添加配置，让Pandas显示完整回溯：

import pandas as pd
pd.set_option('display.max_traceback', None)

也可以通过环境变量PANDAS_DISPLAY_MAX_TRACEBACK=none进行全局设置。

2. 开启Python开发者模式 #

Python 3.11的开发者模式会强制显示完整调用栈，不受Pandas的裁剪影响。Windows下运行脚本时执行：

set PYTHONDEVMODE=1 && python your_script.py

3. 手动捕获并打印完整回溯 #

用traceback模块捕获异常，强制输出完整栈信息：

import traceback
import pandas as pd

try:
    print("Loading stops file...", end=" ")
    df = pd.read_csv("path/to/some.csv")
    df['RegistrationCleaned'] = df['Regristation'].str.replace('*','')
    print("done.")
except Exception as e:
    traceback.print_exc()

总结 #

调整Pandas的回溯显示设置，或者开启Python开发者模式，就能让错误回溯显示你的代码行，大幅提升调试效率。

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