openpyxl3.0官方文档（1）——入门教程

创建工作簿¶

在使用openpyxl库时，无需创建一个空白的Excel文件。只需要导入Workbook类：

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

在Excel工作簿中至少包含一个工作表。可以通过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循环遍历所有的工作表：

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

可以使用Workbook.copy_worksheet()方法在同一个工作簿中创建工作表的副本：

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

只有单元格（包括值、样式、超链接和注释）和某些工作表属性（包括维度、格式和属性）被复制。所有其他工作簿/工作表属性不被复制，例如图像、图表。
也不能在工作簿之间复制工作表。如果工作簿是打开的、只读的或只写的，也不能复制工作表。

处理数据¶

访问一个单元格¶

现在我们知道如何获得工作表，我们可以开始修改单元格内容。可以把单元格位置作为工作表的键直接访问：

    >>> c = ws['A4']

这将返回A4位置的单元格。如果不存在将创建单元格A4。可以直接为单元格赋值：

    >>> ws['A4'] = 4

Worksheet.cell()方法可实现相同作用，该方法使用行和列值实现对单元格的访问：

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

注解
在内存中创建工作表时，它不包含“单元格”。它们是第一次访问时创建的。
警告
由于这个特性，滚动单元格而不是直接访问单元格将在内存中创建所有单元格，即使您没有给它们赋值。
比如：

    >>> 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属性在只读模式下不可用。

操作数值¶

如果只需要工作表中的值，可以使用对象：obj: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()：

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

警告
此操作将覆盖现有文件而不发出警告。
注解
文件扩展名不必是xlsx或xlsm，但如果不使用正式扩展名，则可能在使用其他应用程序直接打开文件时遇到一些问题。
由于OOXML文件基本上是ZIP文件，因此您还可以使用您喜爱的ZIP压缩文档管理器打开它。

保存为流¶

如果要将文件保存到流中，例如在使用网络应用程序（如Pyramid、Flask或Django），则只需提供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

从文件加载¶

和写入Excel文件类似，您可以使用openpyxl.load_workbook()方法打开现有工作簿：

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

本教程到此结束。
翻译不易，烦请大家多多点赞，将更有动力去翻译其他文章。