如何在Pandas导出Excel时实现DataFrame列标题自动换行？

你的问题核心在于：pandas导出Excel时，标题行默认会应用加粗格式，这会覆盖你单独设置的普通换行格式，导致标题无法自动换行。我们需要把换行格式和标题的加粗样式结合起来，同时应用到标题行。

以下是修改后的完整代码，我会标注关键改动：

import pandas as pd

long_text = 'aa aa ss df fff ggh ttr tre ww rr tt ww errr t ttyyy eewww rr55t e'
data = {'a very long column name that needs wrapping':[long_text, long_text, 'a'],
        'another long column title here': [long_text,long_text,long_text], 
        'b':[1,2,3]}
df = pd.DataFrame(data)

# 选择需要换行的列
cols_for_wrap = ['a very long column name that needs wrapping','another long column title here']

writer = pd.ExcelWriter('aaa.xlsx', engine='xlsxwriter')
df.to_excel(writer, sheet_name='Sheet1', index=False)

workbook = writer.book
worksheet = writer.sheets['Sheet1']

# 1. 创建两个格式：一个用于数据行（仅换行），一个用于标题行（换行+加粗）
wrap_format = workbook.add_format({'text_wrap': True})
header_wrap_format = workbook.add_format({'text_wrap': True, 'bold': True})

# 补上原代码缺失的列字母映射字典
d = {i: chr(ord('A') + i) for i in range(len(df.columns))}

# 2. 设置需要换行的列的格式（数据行）
for col in df.columns.get_indexer(cols_for_wrap):
    excel_col = d[col] + ':' + d[col]
    # 设置列宽为20，同时应用换行格式
    worksheet.set_column(excel_col, 20, wrap_format)

# 3. 单独设置标题行的格式：遍历标题行的每个单元格，应用带换行的加粗格式
for col_num, value in enumerate(df.columns.values):
    worksheet.write(0, col_num, value, header_wrap_format)

writer.save()

关键改动说明： #

• 创建了header_wrap_format，同时包含text_wrap: True和bold: True，和pandas默认的标题样式匹配，确保换行效果生效。
• 补上了原代码中缺失的列字母映射字典d，避免报错。
• 遍历标题行的每个单元格，手动应用标题换行格式，覆盖默认的标题样式。
• 调整了列宽为20，让换行效果更明显（你可以根据需求修改）。

如果你的列标题本身已经包含换行符（比如用\n分隔），这个方法同样适用，Excel会自动识别换行符并换行显示。

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