wkhtmltopdf最稳但需本地化资源、指定字体路径和编码；puppeteer更灵活但需控内存与超时；浏览器另存pdf仅适合调试；pdfkit/jspdf不解析html，不适合html转pdf。
用 wkhtmltopdf 命令行转 PDF 最稳，但得绕过字体和 CSS 加载失败
直接调 wkhtmltopdf 是目前最可控的 HTML 转 PDF 方式，尤其适合生成带样式、分页、页眉页脚的文档。但它默认不加载远程字体（比如 Google Fonts）、不执行 JS 渲染动态内容、对相对路径的 CSS/JS 解析也容易出错。
- 确保本地化所有资源：把
@import url(...)的字体换成本地woff2文件，CSS/JS 都用绝对路径或内联（<style></style>/<script></script>） - 加
--no-stop-slow-scripts和--javascript-delay 500应对 JS 渲染延迟，否则 Vue/React 页面可能截空 - 中文乱码？必须指定系统字体路径：
--font-dir /usr/share/fonts/truetype/dejavu/，并用--encoding utf-8 - linux 容器里跑要装
libxrender1、libfontconfig1，否则报错QXcbConnection: Could not connect to display
用 Puppeteer 在 Node.js 里转 PDF 更灵活，但内存和超时得手动管
Puppeteer 能完整走浏览器流程，支持 JS 渲染、截图式 PDF、甚至打印预览级布局，但比 wkhtmltopdf 重，容易卡死或 OOM。
- 启动时加
headless: "new"（不是true），避免旧版 headless 模式下打印行为异常 - PDF 选项别漏掉
printbackground: true，否则 CSSbackground-color全丢 - 超时是高频问题：用
page.waitForNetworkIdle({ timeout: 10000 })替代固定wait(2000)，等真实资源加载完 - 大文件生成记得关掉
devtools和dumpio，否则日志吃光内存
浏览器直接另存为 PDF 看似简单，实际只适合调试，不能进生产
chrome 右键 →「打印」→「另存为 PDF」确实能出效果，但完全不可控：页边距随机、分页断行不可预测、无法批量、不支持模板变量替换。
- 打印样式表（
@media print）必须显式写，否则页面布局全乱，比如display: none的导航栏可能又出来了 - 用
window.print()触发时，会阻塞主线程，用户点一次就卡住，没法监听完成或失败 - PDF 字体嵌入靠浏览器自动处理，Mac 和 windows 渲染结果常不一致，同一份 HTML 在两边生成的 PDF 行高、换行点都不同
PDFKit 或 jsPDF 这类纯 JS 库不适合“HTML 转 PDF”，它们是画布式生成
PDFKit 和 jsPDF 不解析 HTML，而是让你用命令式 API 一行行写文本、画线、插入图片——相当于手写 PDF 结构。拿它硬转 HTML，等于自己实现一个渲染引擎。
立即学习“前端免费学习笔记（深入）”；