如何在 XlsxWriter 中为 Excel 表头设置垂直旋转（90°）-Python教程-PHP中文网

如何在 XlsxWriter 中为 Excel 表头设置垂直旋转（90°）

本文详解如何使用 XlsxWriter 正确实现表头文字 90° 顺时针旋转，避免因混用 to_excel() 与 add_table() 导致的文件损坏或格式失效问题，并提供可直接运行的完整示例。

本文详解如何使用 xlsxwriter 正确实现表头文字 90° 顺时针旋转，避免因混用 `to_excel()` 与 `add_table()` 导致的文件损坏或格式失效问题，并提供可直接运行的完整示例。

在使用 xlsxwriter 导出宽表格（如 69 列）时，列标题过长而列宽受限（例如设为 5），会导致表头文字被截断或重叠，严重影响可读性。将表头文字旋转 90°（即竖排显示）是常见且高效的解决方案。但需特别注意：不能同时依赖 pandas.DataFrame.to_excel() 和 worksheet.add_table() 写入同一区域——二者底层机制冲突，极易导致 Excel 文件损坏（打开时提示“已修复”或丢失标题）。

核心要点在于：必须完全通过 add_table() 构建带格式的表格，禁用 to_excel() 的自动表头写入。XlsxWriter 的 add_table() 支持精细控制每列的 header_format，其中 rotation: -90 即表示顺时针旋转 90°（等效于竖排向上书写）。

以下为推荐的正确实现方式：

Excel XLSX Formula Cleanup

诊断并修复涉及公式、命名范围、Power Query 刷新、数据透视表、VBA/宏保存等问题的 Microsoft Excel XLSX 工作簿

下载

import pandas as pd

data = pd.DataFrame(
    [[1, 2], [3, 4]], 
    columns=["short", "Veeeeeeeeeeeeeeeeeeeeeeeeery long"]
)

with pd.ExcelWriter("rotated_headers.xlsx", engine="xlsxwriter") as writer:
    workbook = writer.book
    worksheet = workbook.add_worksheet("Data")

    # 定义旋转格式：-90° = 顺时针90°（竖排）
    rotate_format = workbook.add_format({
        "rotation": -90,
        "valign": "bottom",  # 文字底部对齐，避免上移出单元格
        "align": "center",
        "font_size": 10,
    })

    # 获取行列尺寸（注意：rows 是数据行数，不含 header；cols 是列数）
    rows, cols = data.shape

    # 手动构建 columns 参数，为特定列指定 header_format
    table_columns = []
    for i, col_name in enumerate(data.columns):
        col_config = {"header": col_name}
        # 可选：仅对超长列应用旋转（保持短列水平显示更清晰）
        if len(col_name) > 15:
            col_config["header_format"] = rotate_format
        table_columns.append(col_config)

    # 关键：使用 add_table() 直接写入数据 + 格式化表头
    # 注意：data.values.tolist() 提供纯 Python 列表数据，不触发 Pandas 格式干扰
    worksheet.add_table(
        0, 0,                    # 左上角位置 (row, col)
        rows, cols - 1,           # 右下角位置 (含 header 行，共 rows+1 行)
        {
            "data": data.values.tolist(),
            "columns": table_columns,
            "banded_rows": True,
            "header_row": True,
        }
    )

✅ 关键注意事项：