开源HTML转PDF工具：WeasyPrint完全使用指南

开源HTML转PDF工具：WeasyPrint完全使用指南

【免费下载链接】wkhtmltopdf项目地址: https://gitcode.com/gh_mirrors/wkh/wkhtmltopdf

WeasyPrint是一款功能强大的开源工具，能够将HTML和CSS文档转换为高质量的PDF文件。与基于WebKit的解决方案不同，WeasyPrint采用纯Python实现，在服务器端渲染方面表现出色，特别适合需要批量处理文档的场景。本文将带你从零开始掌握WeasyPrint的核心功能和使用技巧。

🎯 WeasyPrint核心优势解析

作为一款专业的HTML转PDF工具，WeasyPrint具备以下突出特点：

✅纯Python实现：无需外部依赖，安装部署简单快捷
✅完整CSS支持：包括CSS3和Paged Media规范
✅服务器端友好：完全无头运行，适合自动化流程
✅ 跨平台兼容：支持Windows、Linux和macOS系统
✅ 开源免费：基于BSD许可证，可自由使用和修改

⚡ 快速安装与环境配置

基础安装步骤

通过pip命令即可快速安装WeasyPrint：

# 安装WeasyPrint pip install weasyprint # 验证安装 python -c "import weasyprint; print('安装成功')"

系统依赖处理

在某些Linux系统上，可能需要安装额外的字体包：

# Ubuntu/Debian sudo apt-get install fonts-liberation # CentOS/RHEL sudo yum install liberation-fonts

🛠️ 基础转换与高级功能

简单HTML转PDF

使用WeasyPrint将HTML文件转换为PDF只需几行代码：

from weasyprint import HTML # 转换本地HTML文件 HTML('input.html').write_pdf('output.pdf')

从URL转换网页

WeasyPrint同样支持直接转换网络页面：

from weasyprint import HTML # 转换网页为PDF HTML('https://example.com').write_pdf('webpage.pdf')

📋 实用配置参数详解

常用输出选项配置表

高级功能应用实例

from weasyprint import HTML, CSS from weasyprint.fonts import FontConfiguration # 完整配置示例 font_config = FontConfiguration() html = HTML('report.html') css = CSS('print.css', font_config=font_config) # 生成带自定义样式的PDF html.write_pdf( 'report.pdf', stylesheets=[css], font_config=font_config )

🎨 样式定制与页面布局

CSS分页媒体支持

WeasyPrint对CSS Paged Media模块提供完整支持：

@page { size: A4; margin: 2cm; @top-center { content: "月度报告"; } @bottom-right { content: "Page " counter(page) " of " counter(pages); }

页眉页脚配置

通过CSS伪元素实现专业的页眉页脚：

@page { @top-left { content: "公司名称"; font-size: 10pt; }

🔧 批量处理与自动化

批量转换脚本示例

import os from weasyprint import HTML def batch_convert_html_to_pdf(input_dir, output_dir): for filename in os.listdir(input_dir): if filename.endswith('.html'): input_path = os.path.join(input_dir, filename) output_path = os.path.join(output_dir, filename.replace('.html', '.pdf')) HTML(input_path).write_pdf(output_path) print(f"已转换: {filename}")

📊 性能优化技巧

内存管理最佳实践

from weasyprint import HTML def optimized_conversion(html_content): # 使用上下文管理器确保资源释放 with HTML(string=html_content) as doc: return doc.write_pdf()

🚀 实际应用场景

电商订单生成

from weasyprint import HTML from jinja2 import Template # 模板渲染与PDF生成 template = Template(open('order_template.html').read()) html_content = template.render(order_data=order_info) HTML(string=html_content).write_pdf('order_confirmation.pdf')

报表系统集成

class PDFReportGenerator: def __init__(self): self.html = None def generate_report(self, data, template_path): # 数据填充与PDF生成 self.html = HTML(template_path) return self.html.write_pdf()

💡 常见问题解决方案

字体嵌入问题处理

from weasyprint import HTML import os # 确保字体可用 os.environ['FONTCONFIG_PATH'] = '/usr/share/fonts' HTML('report.html').write_pdf('output.pdf')

图片路径解析

from weasyprint import HTML import os # 设置基础路径 HTML('report.html', base_url=os.path.dirname(__file__)).write_pdf('output.pdf')

🎉 为什么选择WeasyPrint？

✅纯Python架构：易于集成到现有Python项目中
✅完整CSS支持：包括Flexbox、Grid等现代布局
✅服务器端优化：适合高并发处理场景
✅跨平台兼容：一次编写，到处运行
✅开源免费：无使用成本，可自由定制

📚 学习资源与进阶指南

• 官方文档：完整的API参考和使用示例
• 社区支持：活跃的开发者社区和问题解答
• 示例项目：完整的应用案例和最佳实践

通过本指南，你已经掌握了WeasyPrint的核心功能和实用技巧。无论是简单的文档转换还是复杂的报表生成，WeasyPrint都能为你提供稳定可靠的解决方案。现在就开始使用这款强大的开源工具，提升你的工作效率吧！

【免费下载链接】wkhtmltopdf项目地址: https://gitcode.com/gh_mirrors/wkh/wkhtmltopdf