Python实现HTML表格转PDF的3种方案与实战技巧-代码聚汇网

Python实现HTML表格转PDF的3种方案与实战技巧

GreedyAbyss·2026-08-14·阅读 29 GEO检测（免费）

PythonHTML转PDFpdfkit

|难度：普通|阅读约 12 分钟

1. 为什么需要将HTML表格转换为PDF？

在日常开发中，我们经常遇到需要将网页中的表格数据导出为PDF的场景。比如生成财务报表、学生成绩单、产品目录等。PDF格式具有跨平台、不易修改、打印友好等特点，非常适合作为正式文档分发。

Python作为数据处理领域的瑞士军刀，提供了多种方式实现这一需求。我最近在一个电商后台系统中就遇到了类似需求 - 需要将订单数据从HTML格式导出为PDF发票。经过几轮技术选型测试，总结出以下可靠方案。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 主流Python库对比与选型

2.1 pdfkit：基于wkhtmltopdf的解决方案

pdfkit是wkhtmltopdf的Python封装，安装前需要先安装wkhtmltopdf引擎：

bash复制# Ubuntu/Debian
sudo apt-get install wkhtmltopdf
# MacOS
brew install wkhtmltopdf

# 然后安装Python包
pip install pdfkit

基本使用非常简单：

python复制import pdfkit

# 直接转换HTML文件
pdfkit.from_file('table.html', 'output.pdf')

# 或者转换HTML字符串
html = """
<table border="1">
  <tr><th>Name</th><th>Age</th></tr>
  <tr><td>John</td><td>25</td></tr>
</table>
"""
pdfkit.from_string(html, 'output.pdf')

优点：

转换质量高，保留原始样式
支持CSS和JavaScript
简单易用

缺点：

需要额外安装wkhtmltopdf
对复杂布局支持有限

2.2 WeasyPrint：纯Python解决方案

WeasyPrint不需要外部依赖，是纯Python实现的HTML转PDF工具：

bash复制pip install weasyprint

使用示例：

python复制from weasyprint import HTML

HTML(string='<table>...</table>').write_pdf('output.pdf')

优点：

纯Python实现，无需外部依赖
支持现代CSS特性
活跃的开发者社区

缺点：

性能略低于pdfkit
某些JavaScript特性不支持

2.3 Aspose.HTML：企业级解决方案

Aspose.HTML是商业库，提供更专业的转换功能：

python复制import aspose.html as html

# 加载HTML文档
document = html.HTMLDocument("table.html")

# 转换为PDF
html.HtmlDocument.save(document, "output.pdf")

优点：

转换质量极高
支持复杂文档结构
提供技术支持

缺点：

商业授权费用较高
相对较重

3. 实战：保留表格样式的转换技巧

3.1 基础表格样式处理

无论使用哪种工具，都需要确保HTML表格有良好的样式定义：

html复制<style>
  table {
    border-collapse: collapse;
    width: 100%;
  }
  th, td {
    border: 1px solid #ddd;
    padding: 8px;
    text-align: left;
  }
  th {
    background-color: #f2f2f2;
  }
  tr:nth-child(even) {
    background-color: #f9f9f9;
  }
</style>

3.2 分页控制

长表格分页是个常见问题，可以使用CSS控制：

css复制table {
  page-break-inside: auto;
}
tr {
  page-break-inside: avoid;
}
thead {
  display: table-header-group;
}
tfoot {
  display: table-footer-group;
}

3.3 中文支持

确保PDF中包含中文字体：

css复制@font-face {
  font-family: "SimSun";
  src: local("SimSun");
}
body {
  font-family: "SimSun";
}

或者在Python代码中指定字体：

python复制options = {
    'encoding': 'UTF-8',
    'quiet': '',
    'user-style-sheet': '/path/to/styles.css'
}
pdfkit.from_string(html, 'output.pdf', options=options)

4. 高级应用场景

4.1 动态表格生成与转换

结合Jinja2模板引擎动态生成表格：

python复制from jinja2 import Template
import pdfkit

template = Template("""
<table>
  {% for row in data %}
  <tr>
    {% for cell in row %}
    <td>{{ cell }}</td>
    {% endfor %}
  </tr>
  {% endfor %}
</table>
""")

data = [['Name', 'Age'], ['John', '25'], ['Alice', '30']]
html = template.render(data=data)
pdfkit.from_string(html, 'output.pdf')

4.2 批量转换多个表格

使用多线程提高批量转换效率：

python复制from concurrent.futures import ThreadPoolExecutor

def convert_to_pdf(html_file, pdf_file):
    pdfkit.from_file(html_file, pdf_file)

files = [('table1.html', 'output1.pdf'), 
         ('table2.html', 'output2.pdf')]

with ThreadPoolExecutor(max_workers=4) as executor:
    executor.map(lambda f: convert_to_pdf(*f), files)

4.3 添加页眉页脚

通过wkhtmltopdf选项添加页眉页脚：

python复制options = {
    'header-center': '销售报表',
    'footer-right': '第[page]页/共[topage]页'
}
pdfkit.from_file('table.html', 'output.pdf', options=options)

5. 常见问题与解决方案

5.1 表格内容被截断

问题：表格内容超出页面宽度被截断

解决方案：

调整表格宽度：

css复制table {
  width: 95%;
  margin: 0 auto;
}

设置缩放：

python复制options = {
    'viewport-size': '1280x1024',
    'zoom': 0.8
}

5.2 中文乱码

问题：PDF中中文显示为方框