如何在Pandas.ExcelWriter替换工作表时实现列宽自动适配？

你可以结合pandas.to_excel的追加替换功能，再用openpyxl手动调整列宽，具体步骤如下：

核心思路 #

1. 用pandas导出DataFrame到指定工作表，通过mode="a"和if_sheet_exists="replace"实现替换目标表、保留其他表的需求。
2. 用openpyxl加载导出后的Excel文件，遍历目标工作表的每一列，计算内容的最大宽度，设置列宽适配。

代码实现 #

单工作表场景 #

import pandas as pd
from openpyxl import load_workbook
from openpyxl.utils import get_column_letter

# 假设你的DataFrame和文件路径
df = pd.DataFrame({"姓名": ["张三", "李四", "王五"], "年龄": [25, 30, 28], "地址": ["北京市朝阳区", "上海市浦东新区", "广州市天河区"]})
excel_path = "test.xlsx"
target_sheet = "用户信息"

# 1. 导出DataFrame，替换目标工作表
df.to_excel(
    excel_path,
    sheet_name=target_sheet,
    engine="openpyxl",
    mode="a",
    if_sheet_exists="replace",
    index=False  # 根据需求决定是否保留索引
)

# 2. 加载工作簿，自动调整列宽
wb = load_workbook(excel_path)
ws = wb[target_sheet]

for col in ws.columns:
    max_len = 0
    col_letter = get_column_letter(col[0].column)  # 获取列的字母标识（如A、B）
    # 遍历列内所有单元格，计算最大内容长度
    for cell in col:
        try:
            current_len = len(str(cell.value))
            if current_len > max_len:
                max_len = current_len
        except:
            pass  # 处理空单元格等异常情况
    # 设置列宽（+2留边距，*1.5适配中文宽度，可根据实际调整系数）
    ws.column_dimensions[col_letter].width = (max_len + 2) * 1.5

# 保存修改
wb.save(excel_path)

多工作表批量处理 #

如果需要替换多个工作表，可以封装成循环处理：

import pandas as pd
from openpyxl import load_workbook
from openpyxl.utils import get_column_letter

# 定义要替换的工作表与对应DataFrame的映射
sheet_df_map = {
    "用户信息": df_user,
    "订单数据": df_order,
    "商品列表": df_product
}
excel_path = "business_data.xlsx"

for sheet_name, df in sheet_df_map.items():
    # 导出替换工作表
    df.to_excel(
        excel_path,
        sheet_name=sheet_name,
        engine="openpyxl",
        mode="a",
        if_sheet_exists="replace",
        index=False
    )
    # 调整列宽
    wb = load_workbook(excel_path)
    ws = wb[sheet_name]
    for col in ws.columns:
        max_len = 0
        col_letter = get_column_letter(col[0].column)
        for cell in col:
            try:
                current_len = len(str(cell.value))
                if current_len > max_len:
                    max_len = current_len
            except:
                pass
        ws.column_dimensions[col_letter].width = (max_len + 2) * 1.5
    wb.save(excel_path)

关键说明 #

• 列宽系数1.5是为了适配中文显示，英文为主的内容可以调整为1.2或直接用max_len+2。
• 导出时的index=False根据你的需求决定是否保留行索引，若需要保留则删除该参数。
• 每次替换后重新加载工作簿是为了确保获取最新的工作表内容，避免操作旧数据。

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