介绍使用 Python 的 Spire.Doc 库将 Word 文档转换为 PDF 的方法。无需安装 Microsoft Office，适用于服务器及自动化环境。内容包括单文件转换、批量处理脚本、图像压缩、字体嵌入、PDF/A 标准及加密设置等配置选项，并提供了异常处理示例以确保程序稳定性。
在工作中，经常会遇到需要把 Word 文档转换成 PDF 的情况。比如生成报表、分发文档、或者做归档保存，PDF 格式在排版和跨平台显示上更稳定。
传统的做法往往依赖 Microsoft Office 或 LibreOffice 等软件来完成转换，但在自动化环境（如服务器、Docker 容器、Linux 系统）中，这类方式会遇到一些限制：需要额外安装软件、依赖复杂，甚至存在兼容性问题。
因此，很多开发者更希望使用无依赖的 Python 库来完成转换。本文将介绍如何借助 Spire.Doc for Python 库，在不依赖 Office 的情况下，实现 doc 转 pdf、docx 转 pdf，并支持批量转换与多种转换设置。
在使用之前，需要先安装库。可以直接使用以下 pip 命令来安装：
pip install spire.doc
安装完成后，就可以在 Python 代码中使用 导入该库的模块来处理和转换 Word 文档。
from spire.doc import *下面是 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 文件需要转换，可以将它们放在一个目录下，然后遍历目录并批量转换。以下是具体的代码示例：
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 提供了可调节的参数来满足这些需求。
# 将图像压缩到原始质量的 40%
doc.JPEGQuality = 40
# 保留原始图像质量 (图片质量参数：0-100)
# doc.JPEGQuality = 100
这样可以有效减小 PDF 文件大小，适合包含大量图片的 Word 文档。
# 创建 ToPdfParameterList 类的对象
parameter = ToPdfParameterList()
# 将字体嵌入到生成的 PDF 中
parameter.IsEmbeddedAllFonts = True
# 将文档保存为 PDF
doc.SaveToFile("output.pdf", parameter)
避免目标设备缺少字体时，导致 PDF 显示异常。
# 创建 ToPdfParameterList 类的对象
parameters = ToPdfParameterList()
# 设置 PDF/A 合规标准
parameters.PdfConformanceLevel = PdfConformanceLevel.Pdf_A1A
# 将文档保存为 PDF/A-1a 文件
doc.SaveToFile("output.pdf", parameters)
用于生成符合 PDF/A 标准的文件，常用于档案归档。
# 创建 ToPdfParameterList 类的对象
parameter = ToPdfParameterList()
# 设置打开密码和权限密码，并用其保护生成的 PDF 文件
openPsd = "abc123"
permissionPsd = "E-iceblue"
parameter.PdfSecurity.Encrypt(openPsd, permissionPsd, PdfPermissionsFlags.Default, PdfEncryptionKeySize.Key128Bit)
# 将文档保存为加密的 PDF
doc.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()
代码说明：
try ... except ... finally：保证即使出错，程序也能继续执行。print(f"...")：方便输出日志，便于排查问题。finally 确保即使出错，也会关闭文档，避免内存泄漏。本文介绍了在 Python 中使用 Spire.Doc 实现 Word 文档到 PDF 的转换方法。通过实例演示了：
总体来看，利用 Spire.Doc 可以在不依赖 Office 的环境中完成高效、稳定的 Word 到 PDF 转换，并且转换选项灵活，可根据具体需求调整。上述方法适合在报表生成、文档归档或在线文档处理等场景中应用。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online