Spyder IPython控制台Polars多列DataFrame打印错乱的解决办法

问题背景 #

对比Pandas与Polars性能后迁移至Polars，但在Spyder IDE的IPython控制台打印DataFrame时出现显示问题：

• Pandas的多列DataFrame会自动换行，显示正常；
• Polars的多列DataFrame显示错乱，且Spyder IPython控制台无横向滚动条，调整面板宽度无法解决。

示例代码：

import pandas as pd
import polars as pl

df_pd = pd.DataFrame(
    {
        'Extensive_Column_Name_01': [i for i in range(10)],
        'Extensive_Column_Name_02': [i for i in range(10)],
        'Extensive_Column_Name_03': [i for i in range(10)],
        'Extensive_Column_Name_04': [i for i in range(10)],
        'Extensive_Column_Name_05': [i for i in range(10)]
    }    
)

print(df_pd)

df_pl = pl.DataFrame(
    {
        'Extensive_Column_Name_01': [i for i in range(10)],
        'Extensive_Column_Name_02': [i for i in range(10)],
        'Extensive_Column_Name_03': [i for i in range(10)],
        'Extensive_Column_Name_04': [i for i in range(10)],
        'Extensive_Column_Name_05': [i for i in range(10)]
    }    
)

print(df_pl)

可行解决方案 #

方案1：利用Polars内置配置设置打印宽度 #

Polars提供了打印输出宽度的配置项，可根据Spyder控制台的实际显示宽度调整数值，强制DataFrame自动换行：

import polars as pl
# 设置打印宽度为120（可根据控制台实际情况调整）
pl.Config.set_fmt_width(120)

# 之后打印Polars DataFrame即可正常换行
print(df_pl)

方案2：转为Pandas DataFrame打印 #

直接借助Pandas成熟的自动换行逻辑，将Polars DataFrame转为Pandas格式后打印：

# 转为Pandas格式后打印
print(df_pl.to_pandas())

方案3：分块打印列 #

如果列数过多，可将DataFrame按列分块打印，避免单行宽度溢出：

cols = df_pl.columns
# 每次打印2列，可根据需求调整分块大小
chunk_size = 2
for i in range(0, len(cols), chunk_size):
    print(f"--- 列块 {i//chunk_size + 1} ---")
    print(df_pl.select(cols[i:i+chunk_size]))

方案4：调整Spyder控制台输出设置 #

在Spyder中修改IPython控制台的打印宽度上限：

1. 打开Spyder设置（Tools > Preferences）
2. 导航到Console > IPython Console > Display
3. 修改Maximum width for printing的数值，适配控制台宽度
4. 重启IPython控制台生效

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