Playwright 网页 PDF 导出自动化

问题：把网页变成 PDF 并没有看起来那么简单

浏览器自带的「打印为 PDF」只能手动操作，没法批量出报告、定时跑导出任务，也没法把内部系统页面自动归档。截图拼接的脚本方案在分辨率和分页上经常翻车，而服务器环境压根没有图形界面。这个技能要解决的就是：在无显示器的机器上，用代码把指定网页可靠地渲染成版式可控的 PDF。

核心能力与工作方式

技能基于 Playwright 的 chromium.launch() 启动无头 Chromium，再通过 page.pdf() 输出文件，关键配置都集中在 PDFOptions 里：

• 纸张尺寸：支持 A4 与 Letter，覆盖最常见的两种报告规格
• 页眉页脚模板：可注入页码、标题、生成时间，适合归档和分发场景
• 边距配置：四项边距独立可调，避免内容贴边或被裁切
• 无头运行：不需要图形界面，能直接放进 CI、定时任务或容器

典型流程是：启动浏览器实例 → 打开目标 URL → 等待页面就绪 → 调用 page.pdf() 并传入配置 → 写入文件。对 HTML 结构没有特殊要求，只要 Chromium 能正常渲染，就能拿到和浏览器打印视图一致的输出。

适用边界与注意点

• 资料中只覆盖 Chromium 内核；Playwright 还支持 Firefox 和 WebKit，但不在本技能范围内
• 导出效果依赖目标页面自身的 CSS（@page、打印样式表），打印优化不足的页面可能需要先注入样式
• 页眉页脚使用 Playwright 的模板语法，多行或表格类复杂排版能力有限
• 产物是静态 PDF，表单控件、懒加载图表等交互内容需在导出前确认已渲染完成