把一份HTML文件丢进浏览器，转换按下 Ctrl+P，转换选择“另存为PDF”——这是转换最快的办法，十秒钟搞定。转换但如果你要批量处理一百份报表，转换或者想精确控制页眉页脚、转换分页位置，转换浏览器打印对话框那点选项就不够看了。转换我去年帮财务部门做过一个对账单批量转PDF的转换小工具，踩了不少坑，转换下面把几条靠谱路径拆开讲。转换

浏览器打印：能用，转换但别指望太多

Chrome 和 Edge 的转换打印功能底层调用的是 Skia 渲染引擎，出来的转换 PDF 保真度其实相当高。CSS 里的转换 @media print 媒体查询会被正确应用，你可以专门写一套打印样式表，把导航栏、侧边栏这些 display: none 掉。

问题是自动化。用 Puppeteer 驱动无头 Chrome 可以解决批量问题：

const puppeteer = require('puppeteer'); const browser = await puppeteer.launch(); const page = await browser.newPage(); await page.goto('file:///path/to/report.html', { waitUntil: 'networkidle0'}); await page.pdf({ path: 'output.pdf', format: 'A4', printBackground: true}); 

这段代码跑起来很稳。注意 printBackground: true 必须显式加上，否则背景色和背景图全丢。另外 networkidle0 这个等待条件在页面有 WebSocket 长连接时会卡死，换成 networkidle2 或者干脆用 page.waitForSelector 等某个元素出现更可靠。

wkhtmltopdf：老牌工具，坑在字体和JS

这个基于 Qt WebKit 的命令行工具曾经是服务端转 PDF 的首选。用法简单：wkhtmltopdf input.html output.pdf。但它内嵌的 WebKit 版本停留在 2012 年左右，Flexbox 支持稀烂，CSS Grid 完全不认。我遇到过用 display: flex 做的两栏布局，wkhtmltopdf 直接渲染成上下堆叠。

中文字体是另一个雷区。服务器上没装中文字体的话，出来的 PDF 全是方框。解决办法是把字体文件路径写进 CSS 的 @font-face，或者用 --enable-local-file-access 参数配合本地字体文件。JS 执行也要加 --enable-javascript --javascript-delay 2000，给页面留足渲染时间。

WeasyPrint：Python 生态里的体面选择

如果你用 Python，WeasyPrint 值得一试。它不依赖浏览器内核，自己实现了 CSS 2.1 和部分 CSS 3 规范。安装 pip install weasyprint 之后，三行代码完事：

from weasyprint import HTML HTML('input.html').write_pdf('output.pdf') 

它对 @page 规则的支持比 Chrome 还细，可以精确定义每页的尺寸、边距、页眉页脚内容。比如 @page { @bottom-center { content: "第 " counter(page) " 页"; } } 就能自动生成页码。缺点是复杂 CSS 支持有限，position: fixed 的行为和浏览器不一致，浮动元素多了容易错位。

直接生成 PDF 库：绕开 HTML

还有一条路是干脆不用 HTML 做中间格式。Python 的 ReportLab、Node 的 PDFKit 都提供底层 API，直接画线、写字、放图片。控制力最强，但开发成本高——你得自己算坐标、处理换行、管理分页。适合格式固定、批量极大的场景，比如每月十万张发票。普通报表用 HTML 转就够，没必要自找麻烦。

几个实际会踩的坑

分页断裂。表格行被拦腰截断是常见问题，CSS 里加 tr { page-break-inside: avoid; } 能缓解，但 Chrome 对 page-break-inside 的支持时好时坏。更稳的办法是手动控制：给每个逻辑块加 page-break-before: always，牺牲一点空间换确定性。

图片加载。用 Puppeteer 时如果图片是懒加载的，PDF 里会出现空白。把 loading="lazy" 去掉，或者等 page.evaluate 里手动触发所有图片的 load 事件。

字体嵌入。有些 PDF 阅读器对未嵌入字体的文件渲染有问题。Chrome 默认嵌入，wkhtmltopdf 需要加 --embed-fonts 参数。生成之后用 Adobe Acrobat 的“字体”面板检查一下，看到“已嵌入”才放心。

选哪个方案，看你的具体约束。偶尔转几份，浏览器打印最省事。要自动化、要 CSS 支持好，Puppeteer 是首选。Python 项目里不想装 Chrome，WeasyPrint 够用。至于 wkhtmltopdf，除非遗留系统已经依赖它，新项目不建议再碰。