浏览器原生不支持html转pdf的可靠批量导出，必须借助第三方库或服务；window.print()仅触发打印对话框，无法自动保存为pdf，且不可控、不兼容自动化场景。
直接说结论：浏览器原生不支持 HTML 转 PDF 的可靠批量导出，必须借助第三方库或服务；window.print() 只能触发打印对话框，不能自动保存为 PDF 文件。
为什么 window.print() 不等于“导出 PDF”
很多人以为调用 window.print() 就能生成 PDF，其实它只是打开浏览器的打印预览界面，用户必须手动点“另存为 PDF”——这在自动化、后台导出、服务端渲染等场景完全不可行。
- 无法控制页边距、分页、字体嵌入等 PDF 关键参数
- 页面中动态加载的图片、
iframe、Web Font 很可能不显示或错位 - Chrome 的“另存为 PDF”功能依赖本地 GUI 环境，Node.js 或无头服务中根本不可用
- 不同浏览器导出效果差异大（比如 Safari 对 CSS
@media print支持更弱）
前端 JS 导出：用 html2canvas + jsPDF 的真实限制
这是最常被搜到的“纯前端方案”，但实际落地时坑多于便利：
-
html2canvas本质是截图，不是语义化转换：表格跨页会截断、长列表可能内存溢出、position: fixed元素位置错乱 - 中文字符需手动引入字体（如
simhei.ttf），否则导出全是方块；jsPDF默认只支持 14 种基础字体 - CORS 问题高频：页面含跨域图片时，
html2canvas直接报Failed to execute 'toDataURL' on 'HTMLCanvasElement' - 性能差：一个 2000 行的表格可能卡死主线程，移动端基本不可用
示例关键代码：
html2canvas(element).then(canvas => {
const imgData = canvas.toDataURL('image/png');
const pdf = new jsPDF();
pdf.addImage(imgData, 'PNG', 0, 0);
pdf.save('report.pdf');
});
真正可靠的方案：服务端生成（推荐 Playwright 或 Puppeteer）
把 HTML 渲染交给无头浏览器，在服务端生成 PDF，可控性、兼容性、样式还原度远高于前端方案。
立即学习“前端免费学习笔记（深入）”；
-
Puppeteer需 Node.js 环境，依赖 Chromium，page.pdf()支持完整 PDF 参数：format、margin、printBackground、preferCSSPageSize -
Playwright更现代，支持多浏览器内核（WebKit/FF/Chromium），API 更稳定，对 CSS 分页（break-inside: avoid）支持更好 - 必须预加载所有资源：图片、字体、JS 模块，否则 PDF 中留白或报错
net::ERR_ABORTED - 注意内存泄漏：每个 PDF 生成后务必调用
browser.close()，长期运行的服务要加超时和重试
最小可用示例（Playwright）：
const browser = await chromium.launch();
const page = await browser.newPage();
await page.goto('file:///path/to/report.html', { waitUntil: 'networkidle' });
await page.pdf({ path: 'output.pdf', format: 'A4', printBackground: true });
await browser.close();
复杂点在于样式适配：PDF 是静态输出，:hover、@keyframes 全无效；分页逻辑得靠 break-before/break-after 显式控制，而这些在不同浏览器渲染引擎里行为还不一致。别指望一套 CSS 通吃所有导出路径。
