教程
创建工作薄
无需在文件系统上创建文件即可开始使用openpyxl。只需要导入Workbook课程并开始工作：
from openpyxl import Workbook
wb = Workbook()
始终使用至少一个工作表创建一个工作薄。您可以使用Workbook.active属性来获取它：
ws = wb.active
| 默认情况下设置为0。除非您修改其值，否则将始终使用此方法获得第一个工作表。 |
您可以使用以下Workbook.create_sheet()方法创建爱你新的工作表:
from openpyxl import Workbook
wb = Workbook()
ws1 = wb.create_sheet(title=str('MySheet')) # insert at the end(default)
ws2 = wb.create_sheet(title=str('MySheet'), index=0) # insert at first position
ws3 = wb.create_sheet(title=str('MySheet'), index=-1) # insert at penultimate position
在创建表单的时候会自动为其命名。他们按顺序编号(Sheet, Sheet1, Sheet2等)。您可以随时通过Worksheet.title属性更改此名称。
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
ws.title = "New Title"
默认情况下, 包含该标题的选项卡的背景颜色为白色。您可以更改此属性RRGGBB, 为Worksheet.sheet_properties.tabColor属性提供颜色代码：
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
ws.sheet_properties.tabColor = '1072BA'
给工作表命名后，就可以将其作为工作薄的键：
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
ws3 = wb['New Title']
您可以使用Workbook.sheetname属性查看工作薄中所有工作表的名称
from openpyxl import Workbook
wb = Workbook()
print(wb.sheetnames) # ['Sheet2', 'New Title', 'Sheet1']
您可以遍历工作表
from openpyxl import Workbook
wb = Workbook()
for sheet in wb:
print(sheet)
您可以在单个工作薄中创建工作表的副本：
Workbook.copy_worksheet()方法：
from openpyxl import Workbook
wb = Workbook()
source = wb.active
target = wb.copy_worksheet(source)
| 仅复制单元格(包括值,样式,超链接和注释)和某些工作表属性(包括尺寸,格式和属性)。不赋值所有其他工作薄/工作表属性-例如图像, 图表。 您也不能在工作薄之间复制工作表。如果工作薄以只读或** |
| 仅写**模式打开, 则不能复制工作表 |
访问一个单元
现在我们知道了如何获得工作表,我们可以开始修改单元格的内容了。单元格可以直接作为工作表的键进行访问:
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
c = ws['A4']
这将返回A4处的单元格，或者如果尚未存在则创建一个单元格。可以直接分配值：
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
ws['A4'] = 4
还有Worksheet.cell()方法。
这样可以可以行和列表示法访问单元格:
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
d = ws.cell(row=4, column=2, value=10)
| 在内存中创建工作表时,它不包含任何单元格。他们是在首次访问时创建的。 |
| 由于此功能,即时不为他们分配值, 也可以滚动浏览而不是直接访问它们将在内存中全部创建他们。 |
访问多个单元
可以使用切片访问单元格范围:
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)
"""
|
"""
| | | | | | 同样，该Worksheet.iter_cols()方法将返回列：
for col in ws.iter_cols(min_row=1, max_col=3, max_col=2):
for cell in col:
print(cell)
"""
|
"""
| | | | | | 出于性能原因，该Worksheet.iter_cols()方法在只读模式下不可用。 |
如果需要遍历文件的所有行或列，则可以使用以下Worksheet.rows属性：
ws = wb.active
ws['C9'] = 'hello world'
tuple(ws.rows)
"""
((, ,),
(, ,),
(, ,),
(, ,),
(, ,),
(, ,),
(, ,),
(, ,),
(, ,| ),)
"""
| | | | | | | | | | | | | | | | | | | | | | | | | | | 或Worksheet.columns属性：
tuple(ws.columns)
"""
((,
,
,
,
,
,
,
,
),
...
(,
,
,
,
,
,
,
,
| )
"""
| | | | | | | | | | | | | | | | | | 出于性能原因，该Worksheet.columns属性在只读模式在不可用 |
仅值
如果只需要工作表中的值，则可以使用该Workbook.values属性。这将便利工作表中的所有行，但仅返回单元格值:
for row in ws.values:
for value in row:
print(value)
双方Worksheet.iter_rows()并Workbook.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,, 我们就可以为其分配一个值：
v.value = 'hello, world'
print(c.value) # 'hello, world'
d.value = 3.14
print(d.value) # .314
保存到文件
保存工作薄的最简单，最安全的方法是使用对象的Workbook.save()方法：
wb = Workbook()
wb.save('balances.xlsx')
| 此操作将覆盖现有文件，而不会发出警告 |
| 文件名扩展名不是强制为xlsx或xlsm，尽管如果不使用正式扩展名，则可能会直接在其他应用程序中打开它，因此可能会遇到一些麻烦。 由于OOXML文件基本上是ZIP文件，因此您也可以使用自己喜欢的ZIP存档管理器将其打开 |
另存为流 如果要将文件保存到流中，例如在使用WEB应用程序(例如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.xlsx')
或将此属性设置为False(默认)，以另存为文档：
wb = load_workbook('document_template.xlsx')
wb.template = False
wb.save('document.xlsx', as_template=False)
| 您应监视数据属性和文档扩展名以将文档保存在文档模板中，反之亦然，否则结果表引擎将无法打开文档。 |
从文件加载
与书写相同，您可以使用openpyxl.load_workbook()打开现有的工作薄：
from openpyxl import load_workbook
wb2 =load_workdbook('test.xlsx')
print(wb2.sheetnames) # ['sheet2', 'New Title', 'Sheet1']
来源:https://openpyxl.readthedocs.io/en/stable/tutorial.html