WeasyPrint 是 Kozea/CourtBouillon 维护的 HTML/CSS 转 PDF 排版引擎,采用 Python 与 Pango 实现,定位为分页优先的 CSS 引擎,而非无头 Chrome:不执行 JavaScript,不支持 RTL/双向文本,默认使用打印媒体。
主要能力:通过命令行或 Python API 将 HTML/CSS 渲染为普通 PDF,以及 PDF/A、PDF/UA、PDF/X、Factur-X 等格式;支持 @page 分页媒体、URL 资源获取器(fetcher)与 FontConfiguration 字体配置,并提供 fillable forms 等能力。
使用方式:可作 CLI 一次性调用、批量处理,或嵌入 Python 使用。使用 HTML(string=...) 时必须提供 base_url,否则相对资源会失效;不要使用位置参数形式的字符串 HTML。页面尺寸只能通过 @page 或 -s 设置,不存在想象中的 CLI 页面尺寸参数。
适用场景:打印媒体排版、归档/合规 PDF、发票(Factur-X)等。不适用的场景包括 JS 布局、RTL、实时 DOM 与像素级还原屏幕 CSS,这些应改用 Puppeteer 等工具。
限制与安全:默认不支持 :hover、:focus、:visited;不支持 RTL/双向文本;不支持的 CSS 会静默失败。处理不可信 HTML 时禁止开启 presentational_hints(存在 CVE-2026-49452),并需加进程限制、阻止 fetcher 访问 file://。PDF/A 有效性不能仅凭假设,需配合 image-rendering: crisp-edges 与用户侧验证。zoom 非 1 会缩放包括 cm 与 A4 在内的所有单位。样式与浏览器存在差异,字体缺失会导致豆腐块或空白文字,相对资源路径问题通常源于未设置 base_url。以上为资料中明确给出的内容,其余细节暂未提供。