HTML 转 PDF 浏览器打印

解决什么问题

把 HTML 渲染成 PDF 时，常见痛点不是写模板，而是依赖安装和运行环境。很多服务需要 Chromium、Puppeteer 或重型容器，而本地已有 Edge、Chrome、Chromium 时，其实可以直接用系统浏览器的 headless 打印能力。这个技能面向的就是这类需求：在 Windows、macOS 或 Linux 上，把指定 HTML 文件输出为 PDF，避免额外安装浏览器自动化依赖。

工作方式与适用边界

技能会按平台优先级查找可用浏览器：Windows 优先 msedge.exe 和 chrome.exe；macOS 查找 Edge 或 Chrome；Linux 通过 which chromium-browser、which chromium、which google-chrome 或固定路径定位。找到后调用浏览器的 --headless 与 --print-to-pdf 能力，将 file:/// 绝对路径渲染并打印为 PDF。

关键注意点：

• 路径格式：file:/// 后使用正斜杠，反斜杠需转换；
• 版本兼容：资料特别提示不要用 --headless=new，因为旧版 Edge 可能不支持；
• 打印样式：HTML 可用 @media print、@page 控制 A4 等页面尺寸；
• 备用路径：若 headless 生成失败，需要人工在浏览器中打开 HTML，用 Ctrl+P 或 Cmd+P 打印为 PDF。

适合本地文件、报告、行程单等 HTML 输出 PDF；不适合需要复杂服务端调度、高并发渲染或缺少系统浏览器的环境。