openpyxl

openpyxl-一个Python库，用于读/写excel2010 xlsx/xlsm文件¶

作者

埃里克·加佐尼，查理·克拉克

源代码

https://foss.heptapod.net/openpyxl/openpyxl

问题

https://foss.heptapod.net/openpyxl/openpyxl/-/issues

生成

2020 年 11 月 14 日

许可

麻省理工学院

版本

3.0.5

介绍¶

OpenPYXL是一个用于读/写Excel2010 XLSX/XLSM/XLTX/XLTM文件的python库。

它的诞生是由于缺少从Python（OfficeOpenXML格式）本地读/写的现有库。

作为openpyxl，phpexcel团队的所有荣誉最初都基于phpexcel。

安全性¶

默认情况下，openpyxl不防范二次放大或十亿笑XML攻击。为了防止这些攻击，请安装defusedxml。

邮寄名单¶

用户列表可以在http://groups.google.com/group/openpyxl-users上找到。

样本代码：

from openpyxl import Workbook wb = Workbook() # grab the active worksheet ws = wb.active # Data can be assigned directly to cells ws['A1'] = 42 # Rows can also be appended ws.append([1, 2, 3]) # Python types will automatically be converted import datetime ws['A2'] = datetime.datetime.now() # Save the file wb.save('sample.xlsx')

文档¶

文档位于：https://openpyxl.readthedocs.io

• 安装方法

• 代码示例

• 投稿须知

发行说明：https://openpyxl.readthedocs.io/en/stable/changes.html

支持¶

这是一个开源项目，由志愿者在业余时间维护。这很可能意味着缺少您想要的特定功能或功能。但事情不必这样。你可以参与这个项目 开发 您自己或与开发人员签订特定功能的合同。

OpenPYXL的专业支持可从 Clark Consulting & Research 和 Adimian . 欢迎向该项目捐款，以支持进一步的发展和维护。

应使用 issue tracker . 请提供您所看到的任何错误的完整追溯，如果可能，请提供示例文件。如果出于保密的原因，您不能公开一个文件，那么请与开发人员联系。

存储库由提供 Octobus 和 Clever Cloud .

如何贡献¶

任何帮助都将非常感谢，只需遵循以下步骤：

1请加入该组并创建分支(https://foss.heptapod.net/openpyxl/openpyxl/)然后跟着 Merge Request Start Guide . 对于每个独立的特性，不要试图同时修复所有的问题，这对于那些将检查和合并您的更改的人来说更容易些；-）

2。黑客破解

三。不要忘记为您的更改添加单元测试！（是的，即使它是一个一行程序，没有测试的更改也会 not 如果你缺乏专业知识或灵感的话，有很多例子。

4。如果您添加了一个全新的功能，或者只是改进了一些功能，您可以为此感到自豪，因此请将您自己添加到authors文件中：—）

5。让人们知道你刚刚实现的闪光点，更新文档！

6。完成后，只需发出拉请求（点击“拉请求”按钮 your 存储库），然后等待代码被检查，如果您执行了所有这些步骤，则合并到主存储库中。

有关更多信息，请参阅 开发

其他帮助方式¶

贡献有几种方法，即使您不能编码（或不能很好地编码）：

• 在Bug跟踪器上对Bug进行分类：关闭已关闭、不相关、无法复制的Bug，…

• 几乎每个领域都在更新文档：添加了许多大型功能（目前主要是关于图表和图像），但没有任何文档，很难对其进行任何操作。

• 建议对不同版本的Python进行兼容性修复：我们支持3.6、3.7、3.8和3.9。

安装¶

使用pip安装openpyxl。建议在没有系统包的python virtualenv中执行此操作：

$ pip install openpyxl

注解

支持大众 lxml 将在安装时使用的库。这在创建大型文件时特别有用。

警告

为了能够将图像（jpeg、png、bmp…）包含到OpenPyXL文件中，您还需要可以安装的“枕头”库：：

$ pip install pillow

或者浏览https://pypi.python.org/pypi/bellow/，选择最新版本，并在页面底部搜索Windows二进制文件。

使用结账¶

有时，您可能希望使用特定版本的签出。如果bug已经修复，但尚未发布，则可能会出现这种情况。

$ pip install -e hg+https://foss.heptapod.net/openpyxl/openpyxl/@3.0#egg=openpyxl

使用实例¶

教程¶

• 教程
  • 创建工作簿
  • 玩数据游戏
    • 访问一个单元
    • 访问多个单元格
    • 仅值
  • 数据存储
    • 保存到文件
    • 保存为流
  • 从文件加载

食谱¶

• 简单用法
  • 编写工作簿
  • 读取现有工作簿
  • 使用数字格式
  • 使用公式
  • 合并/取消合并单元格
  • 插入图像
  • 折叠（轮廓）

性能¶

• 性能
  • 基准点
    • 写入性能
    • 读取性能
    • 并行化

其他话题¶

• 优化模式
  • 只读模式
  • 只写模式

• 插入和删除行和列，移动单元格范围

• 与熊猫和麻木的人一起工作

• 图表

• 评论

• 使用样式

• 其他工作表属性

• 条件格式

• 基准表

• 打印设置

• 使用筛选和排序

• 验证单元格

• 定义名称

• 工作表

• 正在分析公式

• 保护

开发者信息¶

• 开发

API文档¶

关键类¶

• openpyxl.workbook.workbook.Workbook

• openpyxl.worksheet.worksheet.Worksheet

• openpyxl.cell.cell.Cell

全API¶

• OpenPYXL包
  • 子包