详解xlwt的 Worksheet.set_default_row 函数：设置默认行高

功能

Worksheet.set_default_row 函数用于设置 worksheet 的默认行属性。

使用方法

Worksheet.set_default_row(height=0, style=None) 函数需要两个参数：

• height: 行高，默认为 0（表示自动行高）。
• style: 行样式。

另外，该函数还有一个可选的 keyword-only 参数 update_cols，默认为 False。当该参数为 True 时，该函数会将当前 worksheet 中所有行的高度和样式按照 height 和 style 的值进行更新。

示例

例1

如下示例代码创建了一个 demo.xls 文件，并将一个 5 行 5 列的表格写入其中，其中行高为 20 个像素，标题行使用红底蓝字的样式。注意，这里使用了 “with” 语句来打开和关闭 Excel 文件，这样可以保证文件被正确关闭。

import xlwt

with xlwt.Workbook() as workbook:
    worksheet = workbook.add_sheet('Sheet1')
    default_style = xlwt.easyxf('pattern: pattern solid, fore_colour red; font: bold on, colour blue;')
    worksheet.set_default_row(20, default_style)
    worksheet.write(0, 0, 'Title1')
    worksheet.write(0, 1, 'Title2')
    for row in range(1, 6):
        for col in range(2):
            worksheet.write(row, col, f'Row{row} Col{col}')
    workbook.save('demo.xls')

例2

如下示例代码演示如何使用 Worksheet.set_default_row 函数提高表格写入效率。前提是你需要安装 openpyxl （通过 pip install openpyxl 安装）。

import time
import openpyxl
from openpyxl.cell import Cell
from openpyxl.utils import get_column_letter
from openpyxl.worksheet.worksheet import Worksheet

def write_data(worksheet: Worksheet, nrows: int, ncols: int):
    # 使用 cell 属性一行一行写入数据
    start_time = time.time()
    for row in range(1, nrows+1):
        for col in range(1, ncols+1):
            worksheet.cell(row, col).value = f"Row{row} Col{get_column_letter(col)}"
    end_time = time.time()
    duration1 = end_time - start_time

    # 使用 set_default_row 提速
    start_time = time.time()
    default_style = openpyxl.styles.NamedStyle(name='default_style')
    default_style.font = openpyxl.styles.Font(name='Arial', sz=9)
    default_style.alignment = openpyxl.styles.Alignment(horizontal='center', vertical='center')
    worksheet.row_dimensions[1].height = 20
    worksheet.set_default_row(style=default_style)
    for row in range(2, nrows+1):
        for col in range(1, ncols+1):
            worksheet.cell(row, col).value = f"Row{row} Col{get_column_letter(col)}"
    end_time = time.time()
    duration2 = end_time - start_time

    print(f"With cell: {duration1:.6f}s")
    print(f"With set_default_row: {duration2:.6f}s")

if __name__ == '__main__':
    nrows = 10000
    ncols = 10
    workbook = openpyxl.Workbook()
    worksheet = workbook.active
    write_data(worksheet, nrows, ncols)
    workbook.save("demo.xlsx")

该例中，我们演示了如何使用 Worksheet.set_default_row 函数来提高性能。通过先修改 worksheet.row_dimensions[1].height 和 worksheet.set_default_row(style=default_style) 来为表格的第一行设置行样式和行高，然后在循环写入数据时直接使用 worksheet.cell(row, col).value 来写入，从而避免了重复的行样式和行高设置，提高了写入的速度。