excelize Excel读写

描述

excelize-py 包是 Go 语言 Excelize 库的 Python 移植版本，提供了一组函数，支持读写 XLAM / XLSM / XLSX / XLTM / XLTX 格式文件。支持读取和写入由 Microsoft Excel™ 2007 及更高版本生成的电子表格文档。通过高兼容性支持复杂组件，并提供了流式 API，用于生成或读取包含大量数据的工作表数据。该库需要 Python 3.9 或更高版本。完整的 API 文档可在 docs reference 查看。

基本用法

安装

bash
pip install excelize

创建电子表格

以下是一个最小示例用法，用于创建电子表格文件。

python
import excelize

f = excelize.new_file()
try:
# 创建一个新工作表。
index = f.new_sheet(Sheet2)
# 设置单元格的值。
f.setcellvalue(Sheet2, A2, Hello world.)
f.setcellvalue(Sheet1, B2, 100)
# 设置工作簿的活动工作表。
f.setactivesheet(index)
# 按给定路径保存电子表格。
f.save_as(Book1.xlsx)
except (RuntimeError, TypeError) as err:
print(err)
finally:
err = f.close()
if err:
print(err)

读取电子表格

以下是读取电子表格文档的基本操作。

python
import excelize

try:
f = excelize.open_file(Book1.xlsx)
except (RuntimeError, TypeError) as err:
print(err)
exit()
try:
# 根据给定的工作表名称和单元格引用获取单元格的值。
cell = f.getcellvalue(Sheet1, B2)
print(cell)
# 获取 Sheet1 中的所有行。
rows = f.get_rows(Sheet1)
for row in rows:
for cell in row:
print(f{cell}\t, end=)
print()
except (RuntimeError, TypeError) as err:
print(err)
finally:
# 关闭电子表格。
err = f.close()
if err:
print(err)

向电子表格文件添加图表

使用 Excelize，图表的生成和管理只需几行代码即可完成。您可以根据工作表中的数据构建图表，也可以在工作表中没有任何数据的情况下生成图表。

python
import excelize

f = excelize.new_file()
data = [
[None, Apple, Orange, Pear],
[Small, 2, 3, 3],
[Normal, 5, 2, 4],
[Large, 6, 7, 8],
]
try:
for idx, row in enumerate(data):
cell = excelize.coordinatestocell_name(1, idx + 1, False)
f.setsheetrow(Sheet1, cell, row)
chart = excelize.Chart(
type=excelize.ChartType.Col3DClustered,
series=[
excelize.ChartSeries(
name=Sheet1!$A$2,
categories=Sheet1!$B$1:$D$1,
values=Sheet1!$B$2:$D$2,
),
excelize.ChartSeries(
name=Sheet1!$A$3,
categories=Sheet1!$B$1:$D$1,
values=Sheet1!$B$3:$D$3,
),
excelize.ChartSeries(
name=Sheet1!$A$4,
categories=Sheet1!$B$1:$D$1,
values=Sheet1!$B$4:$D$4,
),
],
title=[excelize.RichTextRun(text=Fruit 3D Clustered Column Chart)],
)
f.add_chart(Sheet1, E1, chart)
# 按给定路径保存电子表格。
f.save_as(Book1.xlsx)
except (RuntimeError, TypeError) as err:
print(err)
finally:
err = f.close()
if err:
print(err)

向电子表格文件添加图片

python
import excelize

try:
f = excelize.open_file(Book1.xlsx)
except (RuntimeError, TypeError) as err:
print(err)
exit()
try:
# 插入一张图片。
f.add_picture(Sheet1, A2, image.png, None)
# 按缩放比例向工作表插入图片。
f.add_picture(Sheet1, D2, image.jpg, excelize.GraphicOptions(
scale_x=0.5,
scale_y=0.5,
))
# 在单元格中插入带偏移量的图片，并支持打印。
f.add_picture(Sheet1, H2, image.gif, excelize.GraphicOptions(
print_object=True,
lockaspectratio=False,
offset_x=15,
offset_y=10,
locked=False,
))
# 按原路径保存电子表格。
f.save()
except (RuntimeError, TypeError) as err:
print(err)
finally:
# 关闭电子表格。
err = f.close()
if err:
print(err)

参考

• - 源代码：github.com/xuri/excelize-py
• 文档仓库：github.com/xuri/excelize-py-docs
• PyPI：pypi.org/project/excelize