如何让pandas生成的Excel文件自动调整列宽以适配内容

pandas本身未内置自动列宽的配置项，可结合你使用的导出引擎对应的API手动实现，两种常用引擎的实现方案如下：

方案1：使用xlsxwriter引擎实现 #

首先确保已安装依赖：pip install xlsxwriter
完整代码示例：

import pandas as pd

# 示例数据
df = pd.DataFrame({
    "长列名测试这是很长的列名1": ["内容1", "这是很长的测试内容需要完整展示", "短内容"],
    "长列名测试这是很长的列名2": ["非常长的内容示例一二三四五六七八九十", "短", "中等长度的内容测试"]
})

# 创建写入对象，指定引擎
with pd.ExcelWriter("output.xlsx", engine="xlsxwriter") as writer:
    df.to_excel(writer, sheet_name="Sheet1", index=False)
    workbook = writer.book
    worksheet = writer.sheets["Sheet1"]
    
    # 遍历所有列，计算适配宽度
    for idx, col in enumerate(df.columns):
        # 计算该列最大字符长度：比较列名长度和列内容的最大长度
        max_len = max(
            df[col].astype(str).map(len).max(),
            len(col)
        ) + 2  # 加2的冗余量，避免内容贴边
        # 设置列宽，xlsxwriter的set_column参数：起始列号，结束列号，宽度
        worksheet.set_column(idx, idx, max_len)

方案2：使用openpyxl引擎实现（默认引擎） #

如果未安装xlsxwriter，默认用openpyxl引擎的话，实现代码如下：
首先确保依赖安装：pip install openpyxl
完整代码示例：

import pandas as pd
from openpyxl.utils import get_column_letter

df = pd.DataFrame({
    "长列名测试这是很长的列名1": ["内容1", "这是很长的测试内容需要完整展示", "短内容"],
    "长列名测试这是很长的列名2": ["非常长的内容示例一二三四五六七八九十", "短", "中等长度的内容测试"]
})

with pd.ExcelWriter("output.xlsx", engine="openpyxl") as writer:
    df.to_excel(writer, sheet_name="Sheet1", index=False)
    workbook = writer.book
    worksheet = writer.sheets["Sheet1"]
    
    # 遍历所有列，openpyxl列号从1开始计数
    for col_idx, col_name in enumerate(df.columns, 1):
        # 计算最大字符长度
        max_len = max(
            df[col_name].astype(str).map(len).max(),
            len(col_name)
        ) + 2
        # 获取列字母标识（比如第1列是A，第2列是B）
        col_letter = get_column_letter(col_idx)
        # 设置列宽
        worksheet.column_dimensions[col_letter].width = max_len

注意事项 #

• 如果数据包含全角字符、emoji等特殊字符，单个字符宽度会大于普通英文字符，可根据实际情况调整冗余量（比如把+2改成+4）
• 如果导出时保留了index列，需要额外把index列也纳入宽度计算逻辑

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