教程

创建工作簿

无需在文件系统上创建文件即可开始使用OpenPYXL。只导入 Workbook 上课开始工作:

>>> from openpyxl import Workbook
>>> wb = Workbook()

一个工作簿总是至少创建一个工作表。你可以通过使用 Workbook.active 属性:

>>> ws = wb.active

注解

默认设置为0。除非修改其值,否则使用此方法将始终获取第一个工作表。

可以使用创建新工作表 Workbook.create_sheet() 方法:

>>> ws1 = wb.create_sheet("Mysheet") # insert at the end (default)
# or
>>> ws2 = wb.create_sheet("Mysheet", 0) # insert at first position
# or
>>> ws3 = wb.create_sheet("Mysheet", -1) # insert at the penultimate position

创建图纸时,会自动为其命名。它们按顺序编号(Sheet,Sheet1,Sheet2,…)。您可以随时使用 Worksheet.title 属性:

ws.title = "New Title"

默认情况下,包含此标题的选项卡的背景色为白色。您可以通过提供 RRGGBB 颜色代码到 Worksheet.sheet_properties.tabColor 属性:

ws.sheet_properties.tabColor = "1072BA"

为工作表命名后,可以将其作为工作簿的键:

>>> ws3 = wb["New Title"]

您可以使用 Workbook.sheetname 属性:

>>> print(wb.sheetnames)
['Sheet2', 'New Title', 'Sheet1']

您可以循环浏览工作表:

>>> for sheet in wb:
...     print(sheet.title)

可以创建工作表的副本 在单个工作簿中

Workbook.copy_worksheet() 方法:

>>> source = wb.active
>>> target = wb.copy_worksheet(source)

注解

只复制单元格(包括值、样式、超链接和注释)和某些工作表属性(包括尺寸、格式和属性)。不复制所有其他工作簿/工作表属性-例如图像、图表。

你也 不能 在工作簿之间复制工作表。如果工作簿在中打开,则无法复制工作表 read-onlywrite-only 模式。

玩数据游戏

访问一个单元

现在我们知道了如何获取工作表,我们可以开始修改单元格内容。单元格可以作为工作表的键直接访问::

>>> c = ws['A4']

这将返回A4处的单元格,或者在还不存在的情况下创建一个单元格。可直接分配值:

>>> ws['A4'] = 4

还有 Worksheet.cell() 方法。

这提供了对使用行和列表示法的单元格的访问:

>>> d = ws.cell(row=4, column=2, value=10)

注解

在内存中创建工作表时,它不包含 cells . 它们是在首次访问时创建的。

警告

由于这个特性,滚动单元格而不是直接访问单元格,将在内存中创建所有单元格,即使您没有给它们赋值。

比如:

>>> for x in range(1,101):
...        for y in range(1,101):
...            ws.cell(row=x, column=y)

将在内存中创建100x100个单元格,不需要任何操作。

访问多个单元格

可以使用切片访问单元格区域::

>>> cell_range = ws['A1':'C2']

可以类似地获得行或列的范围:

>>> colC = ws['C']
>>> col_range = ws['C:D']
>>> row10 = ws[10]
>>> row_range = ws[5:10]

您也可以使用 Worksheet.iter_rows() 方法:

>>> for row in ws.iter_rows(min_row=1, max_col=3, max_row=2):
...    for cell in row:
...        print(cell)
<Cell Sheet1.A1>
<Cell Sheet1.B1>
<Cell Sheet1.C1>
<Cell Sheet1.A2>
<Cell Sheet1.B2>
<Cell Sheet1.C2>

同样地 Worksheet.iter_cols() 方法将返回列:

>>> for col in ws.iter_cols(min_row=1, max_col=3, max_row=2):
...     for cell in col:
...         print(cell)
<Cell Sheet1.A1>
<Cell Sheet1.A2>
<Cell Sheet1.B1>
<Cell Sheet1.B2>
<Cell Sheet1.C1>
<Cell Sheet1.C2>

注解

出于性能原因, Worksheet.iter_cols() 方法在只读模式下不可用。

如果需要遍历文件的所有行或列,则可以使用 Worksheet.rows 属性:

>>> ws = wb.active
>>> ws['C9'] = 'hello world'
>>> tuple(ws.rows)
((<Cell Sheet.A1>, <Cell Sheet.B1>, <Cell Sheet.C1>),
(<Cell Sheet.A2>, <Cell Sheet.B2>, <Cell Sheet.C2>),
(<Cell Sheet.A3>, <Cell Sheet.B3>, <Cell Sheet.C3>),
(<Cell Sheet.A4>, <Cell Sheet.B4>, <Cell Sheet.C4>),
(<Cell Sheet.A5>, <Cell Sheet.B5>, <Cell Sheet.C5>),
(<Cell Sheet.A6>, <Cell Sheet.B6>, <Cell Sheet.C6>),
(<Cell Sheet.A7>, <Cell Sheet.B7>, <Cell Sheet.C7>),
(<Cell Sheet.A8>, <Cell Sheet.B8>, <Cell Sheet.C8>),
(<Cell Sheet.A9>, <Cell Sheet.B9>, <Cell Sheet.C9>))

Worksheet.columns 属性:

>>> tuple(ws.columns)
((<Cell Sheet.A1>,
<Cell Sheet.A2>,
<Cell Sheet.A3>,
<Cell Sheet.A4>,
<Cell Sheet.A5>,
<Cell Sheet.A6>,
...
<Cell Sheet.B7>,
<Cell Sheet.B8>,
<Cell Sheet.B9>),
(<Cell Sheet.C1>,
<Cell Sheet.C2>,
<Cell Sheet.C3>,
<Cell Sheet.C4>,
<Cell Sheet.C5>,
<Cell Sheet.C6>,
<Cell Sheet.C7>,
<Cell Sheet.C8>,
<Cell Sheet.C9>))

注解

出于性能原因, Worksheet.columns 属性在只读模式下不可用。

仅值

如果只需要工作表中的值,可以使用 Worksheet.values 财产。这将迭代工作表中的所有行,但只返回单元格值:

for row in ws.values:
   for value in row:
     print(value)

两个 Worksheet.iter_rows()Worksheet.iter_cols() 可以采取 values_only 仅返回单元格值的参数:

>>> for row in ws.iter_rows(min_row=1, max_col=3, max_row=2, values_only=True):
...   print(row)

(None, None, None)
(None, None, None)

数据存储

一旦我们拥有了 Cell ,我们可以给它赋值:

>>> c.value = 'hello, world'
>>> print(c.value)
'hello, world'

>>> d.value = 3.14
>>> print(d.value)
3.14

保存到文件

保存工作簿的最简单和最安全的方法是使用 Workbook.save() 方法 Workbook 对象:

>>> wb = Workbook()
>>> wb.save('balances.xlsx')

警告

此操作将覆盖现有文件而不发出警告。

注解

文件扩展名不强制为XLSX或XLSM,但是如果不使用正式扩展名,您可能无法直接用另一个应用程序打开它。

由于ooxml文件基本上是zip文件,所以您也可以使用最喜欢的zip存档管理器打开它。

保存为流

如果要将文件保存到流中,例如在使用金字塔、Flask或Django等Web应用程序时,只需提供 NamedTemporaryFile() ::

>>> from tempfile import NamedTemporaryFile
>>> from openpyxl import Workbook
>>> wb = Workbook()
>>> with NamedTemporaryFile() as tmp:
        wb.save(tmp.name)
        tmp.seek(0)
        stream = tmp.read()

可以指定属性 template=True ,将工作簿另存为模板:

>>> wb = load_workbook('document.xlsx')
>>> wb.template = True
>>> wb.save('document_template.xltx')

或将此属性设置为 False (默认),保存为文档:

>>> wb = load_workbook('document_template.xltx')
>>> wb.template = False
>>> wb.save('document.xlsx', as_template=False)

警告

您应该监视数据属性和文档扩展名,以便在文档模板中保存文档,反之亦然,否则结果表引擎无法打开文档。

注解

以下操作将失败:

>>> wb = load_workbook('document.xlsx')
>>> # Need to save with the extension *.xlsx
>>> wb.save('new_document.xlsm')
>>> # MS Excel can't open the document
>>>
>>> # or
>>>
>>> # Need specify attribute keep_vba=True
>>> wb = load_workbook('document.xlsm')
>>> wb.save('new_document.xlsm')
>>> # MS Excel will not open the document
>>>
>>> # or
>>>
>>> wb = load_workbook('document.xltm', keep_vba=True)
>>> # If we need a template document, then we must specify extension as *.xltm.
>>> wb.save('new_document.xlsm')
>>> # MS Excel will not open the document

从文件加载

和写作一样,你可以使用 openpyxl.load_workbook() 打开现有工作簿:

>>> from openpyxl import load_workbook
>>> wb2 = load_workbook('test.xlsx')
>>> print wb2.sheetnames
['Sheet2', 'New Title', 'Sheet1']

本教程到此结束,您可以继续 简单用法 部分