Jupyter Notebook中列显示异常的原因排查与解决方法咨询

效果对照 #

• 实际异常显示效果：
  
• 预期正常显示效果：
  

异常原因 #

该问题属于本地环境配置类问题，不存在代码逻辑错误，核心触发原因有三类：

• pandas默认显示参数阈值过低，长文本、多列场景下会自动触发内容折行、列截断
• Jupyter Notebook前端CSS默认配置了输出区域强制折行规则，DataFrame渲染时会被挤压换行
• pandas与Jupyter版本不兼容，部分跨大版本升级后默认渲染逻辑存在冲突

有效解决方法 #

按优先级从高到低依次尝试：

• 调整pandas全局显示配置
  在Notebook首个单元格运行以下配置代码，从pandas层面解除显示限制：

import pandas as pd
# 取消列数显示上限
pd.set_option('display.max_columns', None)
# 设置单列内容最大显示宽度，可根据自身内容长度调整数值
pd.set_option('display.max_colwidth', 200)
# 设置整行输出宽度，匹配屏幕显示范围
pd.set_option('display.width', 1200)

配置完成后重新运行输出DataFrame的代码单元格即可查看效果。

• 修改Notebook前端渲染样式
  如果调整pandas配置后仍存在折行问题，运行以下代码修改前端CSS规则，关闭强制折行：

from IPython.core.display import display, HTML
display(HTML("""
<style>
/* 禁止DataFrame表头、单元格内容自动折行 */
.dataframe th, .dataframe td {
    white-space: nowrap !important;
    padding: 4px 8px !important;
}
/* 适配输出区域宽度，避免内容溢出被截断 */
div.output_area {
    width: fit-content !important;
    max-width: 98% !important;
    overflow-x: auto !important;
}
</style>
"""))

该配置在当前Notebook运行周期内全局生效，重启内核后需重新运行。

• 修复版本兼容问题
  如果以上两种方法都无效，说明是版本兼容bug，直接在终端运行以下命令升级pandas和notebook到稳定版：

pip install --upgrade pandas jupyter notebook

升级完成后彻底关闭已启动的Jupyter进程，重新启动服务并重启Notebook内核即可。

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