HTML转PDF的全面指南：工具、方法与最佳实践

将HTML文档或网页转换为PDF格式是日常办公和开发中常见的需求。无论是保存网页快照、生成报表还是制作电子书，掌握几种有效的转换方法都能提高效率。本文将从手动到自动化、从桌面到云端，系统介绍各种转换路径。

一、浏览器内置的打印功能

最简单的办法是使用浏览器的“打印”功能（Ctrl+P / Cmd+P），在打印设置中选择“另存为PDF”。大多数现代浏览器（Chrome、Firefox、Edge）都支持此功能，且能较好地保留CSS样式和布局。但此方法适用于少量、一次性转换。

二、命令行工具wkhtmltopdf

wkhtmltopdf是一个基于WebKit引擎的开源工具，可将HTML转换为PDF。它支持页眉页脚、目录、页面尺寸等自定义选项。安装后，只需运行：wkhtmltopdf http://example.com output.pdf。注意：该工具已停止更新，对现代CSS支持有限。

三、使用Puppeteer（Headless Chrome）

Puppeteer是Node.js库，可通过无头Chrome控制页面。它能精确渲染HTML，支持JavaScript、CSS动画和自定义纸张大小。示例代码：

const puppeteer = require('puppeteer');
(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.setContent('<h1>Hello World</h1>');
  await page.pdf({ path: 'output.pdf', format: 'A4' });
  await browser.close();
})();

此方法适合需要动态渲染或高保真度的场景。

四、编程库（Python、PHP等）

除了Puppeteer，其他语言也有对应库：

• Python：pdfkit（封装wkhtmltopdf）、weasyprint（CSS支持更好）、reportlab（底层PDF操作）
• PHP：Dompdf、mPDF、TCPDF，均支持HTML转PDF，但对复杂CSS可能不完美
• Node.js：html-pdf（基于phantomjs，已废弃）、puppeteer（推荐）

五、在线转换服务

若不想安装任何软件，可使用在线服务如ilovepdf.com、pdfcrowd.com。上传HTML文件或输入网址即可转换。注意隐私风险，敏感文档不建议使用。

六、高级技巧：优化与排错

为获得高质量PDF，注意以下要点：

• 确保HTML使用标准DOCTYPE以避免怪异模式。
• 将CSS内联或使用媒体查询@media print控制打印样式。
• 处理分页：使用page-break-before等属性。
• 对于动态内容（如JavaScript图表），使用等待渲染完成的机制。

七、总结

选择哪种方法取决于你的使用场景：

• 偶尔手动转换：浏览器打印功能
• 批量处理且对CSS要求不高：wkhtmltopdf
• 需要高保真和JavaScript支持：Puppeteer或类似无头浏览器
• 嵌入到应用程序中：使用适合语言的库

无论哪种方式，理解HTML渲染原理和PDF限制能帮助你生成更完美的文档。