Python利用pdfkit生成PDF文档的完整实现与避坑指南

Mason

发布时间：2026-10-13| 4人浏览过

原创

本文介绍如何使用Python库pdfkit将HTML或文本内容转换为PDF文件。重点讲解wkhtmltopdf可执行文件的安装路径配置、编码选项设置以解决乱码问题，以及from_file和from_string接口的具体用法。包含完整代码示例，涵盖数据库查询、文件读写及PDF生成的全流程，帮助开发者快速实现文档导出功能。

Python生成PDF方案选择

在Python中导出PDF文档时，经过多方资料对比，发现pdfkit库的效果较为理想。

基于此进行了实际实现，经历多次尝试后成功运行，现将相关经验总结如下。

pdfkit核心配置与代码实现


"""
需要安装pdfkit，另外需要安装可执行文件wkhtmltopdf.exe，
pdfkit核心命令是调用wkhtmltopdf.exe实现转pdf
有三个接口：
pdfkit.from_url
pdfkit.from_string
pdfkit.from_file 需要注意的是，pdfkit主要是用来将html转pdf，所以文件也是html文件或者纯文本文件，其他文件可能失败。
需要用pdfkit.configuration(wkhtmltopdf=path_wk)来说明wkhtmltopdf.exe的安装位置，否则会找不到
options来约定纸张大小，属性'encoding'约定编码，以防乱码
"""
get_cursor = getcursor.GetCursor()
conn = get_cursor.get_native_conn()
cursor = conn.cursor()
sql = 'select * from lease_contract where id = 1'
cursor.execute(sql)
fetchall = cursor.fetchall()
path_wk = r'C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe'
config = pdfkit.configuration(wkhtmltopdf=path_wk)
# 用options来约定编码格式，以防乱码
options = {
 'encoding': 'utf-8'
}
for data in fetchall:
 with open('D:\\testsave.docx', 'w', encoding='utf-8')as f:
  f.write(data[13])
 with open('D:\\testsave.docx', 'r', encoding='utf-8')as f:
  pdfkit.from_file(f, 'D:\\testsave.pdf', configuration=config, options=options)
 pdfkit.from_string(data[13], 'D:\\test.pdf', configuration=config, options=options)