教程 — openpyxl 3.0.7 文档

link管理
链接快照平台
输入网页链接，自动生成快照
标签化管理网页链接
新建工作表 ¶

无须在文件系统中创建文件即可开始使用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)
>>> ws2 = wb.create_sheet("Mysheet", 0) # insert at first position
>>> 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)
文件名后缀并不强制为 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 无法打开这个文档
>>> # 需要执行 keep_vba=True
>>> wb = load_workbook('document.xlsm')
>>> wb.save('new_document.xlsm')
>>> # 微软 Excel 将不会打开这个文档
>>> 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()
从文件加载¶
可以使用 openpyxl.load_workbook() 方法来打开一个已存在的工作表:
>>> from openpyxl import load_workbook
>>> wb2 = load_workbook('test.xlsx')
>>> print wb2.sheetnames
['Sheet2', 'New Title', 'Sheet1']
教程到这里就结束了, 你可以继续 简单用法 部分