当前位置：首页 > news >正文

Python 高效实现 Word 转 PDF：告别 Office 依赖

news 2025/9/12 7:34:01

在工作中，经常会遇到需要把 Word 文档转换成 PDF 的情况。比如生成报表、分发文档、或者做归档保存，PDF 格式在排版和跨平台显示上更稳定。

传统的做法往往依赖 Microsoft Office 或 LibreOffice 等软件来完成转换，但在自动化环境（如服务器、Docker 容器、Linux 系统）中，这类方式会遇到一些限制：需要额外安装软件、依赖复杂，甚至存在兼容性问题。

因此，很多开发者更希望使用无依赖的 Python 库来完成转换。本文将介绍如何借助 Spire.Doc for Python库，在不依赖 Office 的情况下，实现 doc 转 pdf、docx 转 pdf，并支持批量转换与多种转换设置。

一、安装 Spire.Doc for Python

在使用之前，需要先安装库。可以直接使用以下 pip 命令来安装：

pip install spire-doc

安装完成后，就可以在 Python 代码中使用 from spire.doc import * 导入该库的模块来处理和转换 Word 文档。

二、Python Word 转 PDF 基本示例

下面是 Word 转 PDF 一个最基础的示例。只需要两步：加载文件、保存为 PDF。

from spire.doc import *# 创建文档对象
doc = Document()# 加载 Word 文件
doc.LoadFromFile("input.docx")# 转换并保存为 PDF
doc.SaveToFile("output.pdf", FileFormat.PDF)# 关闭文档，释放资源
doc.Close()

代码说明：

Document()：创建一个 Word 文档对象。
LoadFromFile("input.docx")：加载指定路径的 Word 文件。
SaveToFile("output.pdf", FileFormat.PDF)：将文档保存为 PDF 格式。
Close()：关闭文档，释放资源。

三、批量转换 Word 文档为 PDF

如果有大量 Word 文件需要转换，可以将它们放在一个目录下，然后遍历目录并批量转换。以下是具体的代码示例：

import os
from spire.doc import *input_dir = "word_files"
output_dir = "pdf_files"
os.makedirs(output_dir, exist_ok=True)for file in os.listdir(input_dir):if file.endswith(".doc") or file.endswith(".docx"):doc = Document()doc.LoadFromFile(os.path.join(input_dir, file))pdf_path = os.path.join(output_dir, file.rsplit(".", 1)[0] + ".pdf")doc.SaveToFile(pdf_path, FileFormat.PDF)doc.Close()

代码说明：

os.listdir(input_dir)：遍历文件夹中的所有文件。
file.endswith(".doc") or file.endswith(".docx")：只处理 Word （.doc 或 .docx）文件。
os.makedirs(output_dir, exist_ok=True)：如果目标文件夹不存在，则自动创建。
每次处理完一个文档后调用 Close()，避免内存占用过多。

四、转换设置与优化

在不同的应用场景下，生成的 PDF 可能需要不同的属性，例如文件体积更小、排版更精细、符合归档标准等。Spire.Doc for Python 提供了可调节的参数来满足这些需求。

1. 图片优化（减小 PDF 大小）

# 将图像压缩到原始质量的40%
doc.JPEGQuality = 40# 保留原始图像质量 (图片质量参数：0-100)
# doc.JPEGQuality = 100

这样可以有效减小 PDF 文件大小，适合包含大量图片的 Word 文档。

2. 字体嵌入处理（避免乱码）

# 创建 ToPdfParameterList 类的对象
parameter = ToPdfParameterList()# 将字体嵌入到生成的PDF中
parameter.IsEmbeddedAllFonts = True# 将文档保存为PDF
document.SaveToFile("output.pdf", parameter)

避免目标设备缺少字体时，导致 PDF 显示异常。

3. PDF/A 合规标准

# 创建 ToPdfParameterList 类的对象
parameters = ToPdfParameterList()# 设置 PDF/A 合规标准
parameters.PdfConformanceLevel = PdfConformanceLevel.Pdf_A1A# 将文档保存为 PDF/A-1a 文件
document.SaveToFile("output.pdf", parameters)

用于生成符合 PDF/A 标准的文件，常用于档案归档。

4. 加密与权限控制

# 创建 ToPdfParameterList 类的对象
parameter = ToPdfParameterList()# 设置打开密码和权限密码，并用其保护生成的 PDF 文件
openPsd = "abc123"
permissionPsd = "E-iceblue"
parameter.PdfSecurity.Encrypt(openPsd, permissionPsd, PdfPermissionsFlags.Default, PdfEncryptionKeySize.Key128Bit)# 将文档保存为加密的PDF
document.SaveToFile("output.pdf", parameter)

可以为 PDF 设置打开密码，并限制打印、复制等操作。

五、异常处理

import os
from spire.doc import *input_dir = "word_files"
output_dir = "pdf_files"
os.makedirs(output_dir, exist_ok=True)for file in os.listdir(input_dir):if file.endswith(".doc") or file.endswith(".docx"):try:doc = Document()doc.LoadFromFile(os.path.join(input_dir, file))pdf_path = os.path.join(output_dir, file.rsplit(".", 1)[0] + ".pdf")doc.SaveToFile(pdf_path, FileFormat.PDF)print(f"成功转换: {file} → {pdf_path}")except Exception as e:print(f"转换失败: {file}, 错误信息: {str(e)}")finally:if 'doc' in locals():doc.Close()

代码说明：