Python用Spire.Doc实现Word与RTF互转

脚本专家

在跨平台文档交换中，Word 与 RTF 的互转是比较常见的需求。Word（.doc/.docx）排版和编辑功能完善，但跨系统传递时可能遇到兼容性问题；RTF 作为通用富文本格式，能保留字体、段落、表格等基础样式，跨平台兼容性较好。本文基于 Spire.Doc for Python 说明双向转换的代码实现、参数含义和实际使用中的限制。

一、格式差异与转换场景

Word 文档是微软办公套件的默认格式，支持复杂样式、嵌入对象和宏。RTF 是一种较早的标记语言格式，用于在不同文字处理软件之间交换格式化文本。RTF 对字体、粗体、斜体、段落对齐等基础格式支持良好，但 Word 中的主题、SmartArt、图表、宏、文档属性等复杂功能，在 RTF 中没有对应表示，转换时无法保留。

RTF 文件使用纯文本编码且未压缩，相同内容下体积通常比 .docx 更大。因此，Word 转 RTF 多用于提高文档在异构环境中的可打开性；RTF 转 Word 则是为了利用更完整的编辑功能。

二、使用的库与安装

本文示例基于 Spire.Doc for Python。它是一个独立的 Python Word 处理库，运行时不需要系统中安装 Microsoft Word，支持 Word 97-2003 至 Word 2019 的读写，以及 RTF、TXT、HTML、PDF 等多种格式互转。

安装命令：

2. pip install spire.doc

复制代码

三、Word 转 RTF

核心逻辑是创建 Document 对象，加载 Word 文件，再以 RTF 格式保存：

2. from spire.doc import *
3. from spire.doc.common import *
5. # 创建 Document 实例
6. document = Document()
8. # 加载 Word 文档
9. document.LoadFromFile("input.docx")
11. # 保存为 RTF 格式
12. document.SaveToFile("output.rtf", FileFormat.Rtf)
14. # 释放资源
15. document.Close()

复制代码

其中，LoadFromFile 会根据文件扩展名自动识别格式；SaveToFile 的第二个参数 FileFormat.Rtf 指定输出为 RTF。转换时库会尽量保留原文档的基础格式元素，但 Word 特有的宏、主题、SmartArt、图表、文档变量等内容，在 RTF 格式本身中就没有对应表示，因此无法保留。这是格式能力边界，而不是转换工具本身的问题。

四、RTF 转 Word

反向转换的代码结构基本一致，只是加载和保存的格式互换：

2. from spire.doc import *
3. from spire.doc.common import *
5. # 创建 Document 实例
6. document = Document()
8. # 加载 RTF 文件
9. document.LoadFromFile("input.rtf")
11. # 保存为 Word 文档
12. document.SaveToFile("output.docx", FileFormat.Docx)
14. # 释放资源
15. document.Close()

复制代码

这里使用 FileFormat.Docx 作为输出格式。该库也支持 FileFormat.Docx2019 等版本特定的枚举值，但根据社区反馈，带版本号的枚举值在后续版本中逐渐被通用值替代，长期维护时使用 FileFormat.Docx 更稳妥。

从 RTF 转 Word 时，基础格式通常能较好保留，因为 Word 对 RTF 的兼容性一直较好。RTF 中不支持的富媒体内容，如分组图形、图表、方程等，转换后也不会出现，因为源文件中本来就不存在这些内容。

五、常见注意事项

1. 资源释放：每次转换完成后调用 Close()，可以及时释放文档对象占用的资源。虽然 Python 垃圾回收最终会处理这些对象，但在批量处理多个文档时，显式关闭有助于控制内存占用。

2. 免费版限制：该库免费版本存在 500 个段落和 25 个表格的限制，在读取或写入文件时生效；将 Word 转为 PDF/XPS 时仅输出前 3 页。如果处理较大文档或需要批量转换，可能会遇到功能约束。商业版没有这些限制。

3. 格式保真度预期：RTF 作为较早的格式，对现代 Word 特性的支持存在边界。从 Word 转为 RTF 时，如果原文档依赖文本效果、特定类型的图形对象、页面边框的某些样式等较新排版功能，转换结果可能有所简化。建议转换后抽查关键格式元素，确认满足使用需求。

4. 版本兼容性：该库 API 在主要版本之间有过调整，除了导入路径变化外，文件格式枚举也从版本特定的值向通用值迁移。如果从旧代码迁移，或查阅较早资料，需要注意这一点。

六、小结

Python 中实现 Word 与 RTF 双向转换，核心代码主要涉及 LoadFromFile 和 SaveToFile 两个方法。这种方式不依赖 Microsoft Word 安装，适合在服务器或自动化流程中使用。选择方案时需要权衡格式兼容性与内容保真度：RTF 的跨平台优势以牺牲部分高级格式支持为代价；如果文档主要用于简单文字交换和基础排版，RTF 是合适选择；如果需要保留复杂文档结构，直接使用 Word 格式可能更稳妥。