欢迎阅读本文：temperature=0.6如何用 Python 操作 ODT 文档？odfpy 库从入门到实战的完整教程，本文将带你从零基础到实战的步骤，使用 odfpy 来对 OpenDocument Text 文件进行创建、读取和修改，帮助你快速在自动化脚本中处理文字文档。
ODF/ODT 与 odfpy 的关系
ODF、ODT 与 odfpy 的核心概念
ODF 是一个开放的文档格式标准，采用 XML 结构承载内容与样式；ODT 是其中针对文字处理的实现文件，通常以 .odt 扩展名保存。odfpy 则提供了 Python 层的 API，让开发者可以直接用代码创建、读取、修改以及保存 ODT 文档，而无需手工拼装 XML。
了解 XML 的结构是关键：文本段落、样式、表格、图片等都以 XML 节点的方式组织。通过 odfpy，你可以向文档注入新的段落、文本片段，或调整现有元素的属性，从而实现完全的自动化文档处理。
环境准备与安装
安装 odfpy 的步骤
第一步通常是通过包管理器安装 odfpy，确保你的 Python 环境已经就绪。安装命令应在虚拟环境内执行，以避免依赖冲突。
pip install odfpy如果你使用的是虚拟环境，前置步骤可能包含创建与激活环境，例如：
python -m venv venv
# Linux/macOS
source venv/bin/activate
# Windows
venv\\Scripts\\activate
pip install odfpy在虚拟环境中管理依赖
为确保项目可移植性，除了安装 odfpy 外，最好将依赖记录在 requirements.txt 中，并使用锁版本来避免潜在的兼容性问题。
# 将当前环境中已安装的包导出
pip freeze > requirements.txt
随后在其他环境中可以通过 pip install -r requirements.txt 来还原一致的依赖集合。
打开、读取与写入 ODT 文档
打开文档
要对一个现有的 ODT 文档进行操作，先将文档加载到 Python 对象树中，再进行遍历或修改。
from odf.opendocument import load# 加载现有的 ODT 文档
doc = load("example.odt")
print(type(doc))
加载完成后，你可以查看文档的结构，例如样式、段落、表格等。
读取段落文本
读取文档中的文本段落通常需要定位到 P（段落节点），遍历并提取其中的文本内容。
from odf.opendocument import load
from odf.text import Pdoc = load("example.odt")
paras = [p for p in doc.getElementsByType(P)]
for p in paras:if p.firstChild is not None:text = p.firstChild.dataprint(text)
创建新文档、追加文本与样式
新建文档
除了修改现有文档，你也可以创建一个全新的 OpenDocument 文本对象，并逐步添加文本与段落，然后保存为 .odt 文件。
from odf.opendocument import OpenDocumentText
from odf.text import Pdoc = OpenDocumentText()
p = P(text="这是新建的段落，使用 odfpy 进行创建。")
doc.text.addElement(p)
doc.save("newfile.odt")
新建文档时，你可以按需添加多个段落，构造完整的文档结构。
应用文本样式
为了提高文档可读性和美观性，可以定义并应用自定义样式，再将样式应用到段落上。
from odf.style import Style, TextProperties
from odf.text import P
from odf.opendocument import OpenDocumentTextdoc = OpenDocumentText()
style = Style(name="Bold14", family="Paragraph")
style.addElement(TextProperties(fontweight="bold", fontsize="14pt"))
doc.styles.addElement(style)p = P(text="加粗样式示例文本")
p.setAttribute("stylename", "Bold14") # 应用样式
doc.text.addElement(p)
doc.save("styled.odt")
样式、段落和元数据
修改元数据
元数据用于描述文档的作者、标题、主题等信息，适当设置元数据有助于文档管理和检索。
from odf.opendocument import load
from odf.meta import Meta, UserDefineddoc = load("styled.odt")
# 创建一个自定义元数据项
ud = UserDefined(name="creator", value="YourName")
doc.meta.addElement(ud)
doc.save("styled_with_meta.odt")
段落与列表的处理
odfpy 也支持对段落、列表等结构的处理，你可以在段落之外添加列表、标题等元素，以丰富文档结构。
from odf.opendocument import OpenDocumentText
from odf.text import P, List, ListItemdoc = OpenDocumentText()
doc.text.addElement(P(text="这是一个普通段落。"))# 简单有序列表示例
list_el = List(start="1")
list_el.addElement(ListItem(text="第一项"))
list_el.addElement(ListItem(text="第二项"))
doc.text.addElement(list_el)doc.save("list_example.odt")
实战示例：从入门到实战的工作流
从模板到自动化脚本
在实际场景中，你可能需要读取模板、填充数据，然后输出到新的 ODT 文件。下面的示例展示了一个基础工作流：加载模板、添加段落、应用样式并保存。
from odf.opendocument import load
from odf.style import Style, TextProperties
from odf.text import P# 1. 读取模板
template = load("template.odt")# 2. 添加文本
p1 = P(text="自动化填充：订单号 20250824-XYZ，金额 ¥199.99")
template.text.addElement(p1)# 3. 应用统一样式
style = Style(name="AutoBold", family="Paragraph")
style.addElement(TextProperties(fontweight="bold", fontsize="11pt"))
template.styles.addElement(style)
p1.setAttribute("stylename", "AutoBold")# 4. 保存输出
template.save("filled_output.odt")
通过上面的步骤，你可以把数据从数据库、CSV 或 API 自动推送到 ODT 文档中，这对于生成报告、发票、合规文档等场景尤为有用。上述代码中的各个环节都可以逐步扩展为完整的自动化脚本，以实现端到端的文档生成与分发。请根据实际需求调整字体、行距和页边距等参数，以达到最佳的排版效果。
