教程¶
新建工作表¶
无须在文件系统中创建文件即可开始使用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 method:
>>> source = wb.active
>>> target = wb.copy_worksheet(source)
注解
只有单元格（包含值、样式、超链接和注释）以及确定的工作簿属性（包含尺寸、格式和属性）会被复制。 其余的工作表/工作簿属性都不会被复制，例如：文件、图表。
你也**不能**跨工作表复制工作簿。工作表以 read-only 或 write_only 模式打开时也无法复制。
Playing with data¶
访问单元格¶
现在我们已经知道如何创建工作表，接下来可以开始修改单元格内容了。 可以直接通过工作表的键来访问单元格:
>>> c = ws['A4']
此处会返回 A4 单元格，如果不存在不将会进行创建 可以直接分配值:
>>> ws['A4'] = 4
这里是 Worksheet.cell 方法.
也可以通过行列符号访问单元格:
>>> d = ws.cell(row=4, column=2, value=10)
注解
当工作薄在内存中被创建之后并没有单元格 cells ，单元格只有在被第一次访问(access)的时候才会创建
警告
由于这个特性，即使你未对单元格赋值，滚动浏览而非直接访问时也会在内存中直接创建。
Something like
>>> for x in range(1,101):
... for y in range(1,101):
... ws.cell(row=x, column=y)
will create 100x100 cells in memory, for nothing.
访问大量单元格¶
可以使用切片来访问一系列单元格:
>>> 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 方法在只读模式下不可用。
Values only¶
如果你只想要工作薄的值，你可以使用 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 类的 Workbook.save() 方法:
>>> wb = Workbook()
>>> wb.save('balances.xlsx')
警告
这个操作将会无警告直接覆盖已有文件
注解
文件名后缀并不强制为 xlsx 或 xlsm，但是如果没使用官方后缀名，会在用其他应用打开时遇到一些麻烦。
由于 OOXML 文件基本上都是 ZIP 文件，你也可以用你喜欢的 ZIP 压缩管理器打开
你可以指定属性 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')
>>> # 需要保存为 *.xlsx 拓展名
>>> wb.save('new_document.xlsm')
>>> # 微软 Excel 无法打开这个文档
>>>
>>> # or
>>>
>>> # 需要执行 keep_vba=True
>>> wb = load_workbook('document.xlsm')
>>> wb.save('new_document.xlsm')
>>> # 微软 Excel 将不会打开这个文档
>>>
>>> # or
>>>
>>> wb = load_workbook('document.xltm', keep_vba=True)
>>> # 如果需要一个模板文档，需要将拓展名指定为 *.xltm.
>>> wb.save('new_document.xlsm')
>>> # 微软 Excel 将不会打开这个文档
保存成流(stream)¶
如果想把文件保存成流。例如当使用 Pyramid, 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()