如何为DataFrame的所有列设置文本自动换行？

场景1：在Jupyter Notebook/IPython中显示DataFrame时实现自动换行 #

直接使用Styler对象设置全局样式，让所有列的文本自动换行：

import pandas as pd

# 示例DataFrame
df = pd.DataFrame({
    '长文本列1': ['这是一段非常长的文本内容，需要自动换行显示才能完整看到全部信息', '另一段超长的测试文本'],
    '长文本列2': ['这里的内容也很长，不换行的话会被截断或者横向撑宽表格', '测试文本2']
})

# 为所有列设置自动换行样式
styled_df = df.style.set_properties(**{'white-space': 'pre-wrap', 'text-align': 'left'})
styled_df

这段代码通过CSS的white-space: pre-wrap属性，让单元格内的文本根据单元格宽度自动换行，同时保留文本原有格式。

如果之前用pd.options.display.max_colwidth设置没生效，是因为它仅限制列的最大显示宽度，超过阈值后会截断文本或显示省略号，并非真正意义上的自动换行；而Styler的样式设置直接作用于单元格渲染，效果更直观。

场景2：将DataFrame导出到Excel时实现自动换行 #

如果需要导出到Excel后保持自动换行，需指定对应引擎并设置单元格格式：

使用xlsxwriter引擎 #

# 创建Excel写入对象
writer = pd.ExcelWriter('带自动换行的表格.xlsx', engine='xlsxwriter')
df.to_excel(writer, sheet_name='Sheet1', index=False)

# 获取工作簿和工作表对象
workbook = writer.book
worksheet = writer.sheets['Sheet1']

# 设置自动换行格式
wrap_format = workbook.add_format({'text_wrap': True})

# 应用格式到所有列
for col_num in range(len(df.columns)):
    worksheet.set_column(col_num, col_num, None, wrap_format)

writer.close()

使用openpyxl引擎 #

from openpyxl import load_workbook

df.to_excel('带自动换行的表格.xlsx', index=False, engine='openpyxl')

# 加载已保存的Excel文件
wb = load_workbook('带自动换行的表格.xlsx')
ws = wb.active

# 遍历所有单元格设置自动换行
for row in ws.iter_rows():
    for cell in row:
        cell.alignment = cell.alignment.copy(wrap_text=True)

wb.save('带自动换行的表格.xlsx')

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