Jupyter Notebook突然以文本形式显示DataFrame的原因及解决办法

可能的原因及对应解决方案 #

1. Pandas显示配置被修改

Pandas默认的HTML表格渲染规则可能被手动关闭或第三方库篡改，导致输出切换为纯文本格式。

解决步骤：

• 重置所有Pandas显示配置，恢复默认设置：

import pandas as pd
pd.reset_option('all')

• 执行上述代码后，再运行df.head()查看是否恢复表格显示。

• 若重置无效，手动强制启用HTML渲染：

pd.set_option('display.notebook_repr_html', True)

2. IPython显示格式化器异常

Jupyter依赖IPython的显示格式化器渲染Pandas表格，若格式化器未正确绑定Pandas的HTML渲染逻辑，会导致纯文本输出。

解决步骤：

• 重新注册Pandas的HTML渲染器：

from IPython.display import display
import pandas as pd

# 重新绑定DataFrame的HTML渲染方法
get_ipython().display_formatter.formatters['text/html'].for_type(
    pd.DataFrame, pd.DataFrame._repr_html_
)

• 执行后用display(df.head())测试效果。

3. Jupyter内核异常

内核长时间运行或缓存出错，可能导致渲染模块失效。

解决步骤：

• 点击Jupyter顶部菜单栏「Kernel」→「Restart Kernel」，重启后重新运行代码。
• 若重启无效，新建空白笔记本，导入数据后测试df.head()，排除当前笔记本的配置问题。

4. 第三方库干扰

部分库（如tabulate、pandas_markdown）会修改Pandas的默认输出格式，替换HTML表格为纯文本。

解决步骤：

• 检查环境是否安装此类库，临时卸载测试：

pip uninstall tabulate -y

• 卸载后重启内核，再测试表格显示。

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