Pandas导出Excel时无法按列最大字符串长度设置列宽问题

pandas的Styler.set_properties()设置的width是CSS样式属性，Excel不支持解析这类样式，因此导出后列宽不会生效。Styler的核心设计是用于生成HTML格式的带样式表格，对Excel的样式支持有限。

要实现Excel列宽匹配内容最大长度，需借助Excel写入引擎（如xlsxwriter或openpyxl）直接操作列宽，而非通过Styler。以下是两种可行方案：

方案1：使用xlsxwriter引擎 #

import pandas as pd

# 替换成你的数据框
df = pd.DataFrame({
    '短列': ['a', 'b', 'c'],
    '长内容列': ['这是一段较长的文本', '测试内容', 'another long string']
})

# 计算每列的目标宽度：取列名长度和内容最大长度的较大值，加2留余量
column_widths = []
for col in df.columns:
    col_len = len(str(col))
    content_max_len = df[col].astype(str).str.len().max()
    column_widths.append(max(col_len, content_max_len) + 2)

# 导出并设置列宽
with pd.ExcelWriter('C:/Users/test.xlsx', engine='xlsxwriter') as writer:
    df.to_excel(writer, index=False, sheet_name='Sheet1')
    worksheet = writer.sheets['Sheet1']
    
    # 逐列设置宽度
    for idx, width in enumerate(column_widths):
        worksheet.set_column(idx, idx, width)

方案2：使用openpyxl引擎 #

import pandas as pd
from openpyxl import load_workbook

# 替换成你的数据框
df = pd.DataFrame({
    '短列': ['a', 'b', 'c'],
    '长内容列': ['这是一段较长的文本', '测试内容', 'another long string']
})

# 先导出基础Excel
df.to_excel('C:/Users/test.xlsx', index=False, engine='openpyxl')

# 加载文件并调整列宽
wb = load_workbook('C:/Users/test.xlsx')
ws = wb.active

for col in ws.columns:
    # 计算当前列所有单元格内容的最大长度（包含表头）
    max_len = max(len(str(cell.value)) for cell in col) + 2
    # 通过列字母设置宽度
    ws.column_dimensions[col[0].column_letter].width = max_len

wb.save('C:/Users/test.xlsx')

• Excel的列宽单位是默认字体下的字符数，而非像素，直接用字符长度设置更贴合需求，加2是为了避免内容边缘被截断。
• 如果需要保留Styler设置的其他样式，可以先导出带样式的Excel，再用上述方法二次修改列宽。

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