wkhtmltopdf 是最稳的本地 PDF 生成工具，兼容性好、控制精细，需加 --enable-local-file-access 和中文字体参数；puppeteer 更灵活但重，weasyprint 最轻量但不支持 JS。
用 wkhtmltopdf 命令行直接转，最稳
本地生成 pdf 且不依赖浏览器环境时，wkhtmltopdf 是目前兼容性最好、控制最细的选择。它本质是 headless webkit 渲染器，能正确处理 css 媒体查询（比如 @media print）、相对路径资源和基础 javascript。
- 安装后直接运行：
wkhtmltopdf input.html output.pdf - 关键参数要加：
--enable-local-file-access（否则本地file://资源加载失败） - 中文乱码？必须指定字体：
--font-family "Noto Sans CJK SC"或系统已安装的中文字体名 - 页边距、A4 尺寸等用
--margin-top 20 --page-size A4控制，不设会默认用屏幕尺寸渲染
前端调用 window.print() 打印成 PDF 不可靠
浏览器“另存为 PDF”功能看似简单，但实际是用户手动操作，无法自动化；且输出效果受当前页面 CSS、缩放比例、打印预设影响极大，同一页面在 Chrome/Firefox/Edge 下生成的 PDF 布局可能完全不同。
- 触发后无法控制文件名、路径、页眉页脚内容
-
@media print规则若没写全（比如漏了display: none隐藏按钮），PDF 里就会多出不该出现的元素 - JavaScript 动态渲染的内容（如
document.write或 Vue/React 初始化后才挂载的 DOM）大概率不进 PDF
Node.js 里用 puppeteer 生成 PDF 更灵活但更重
适合需要等 JS 执行完、截图式渲染、或要注入自定义样式/脚本的场景。但它启动 Chromium 实例，内存占用高，冷启动慢，不适合高频小文件转换。
- 基本写法：
await page.goto('file:///path/to/input.html', { waitUntil: 'networkidle0' }) - 务必加
waitUntil: 'networkidle0'，否则异步加载的图片、字体可能缺失 - 导出前建议显式设置视口：
await page.setViewport({ width: 1200, height: 800 })，避免响应式布局错乱 - PDF 字体嵌入麻烦：CSS 中用
@font-face引入的字体，需确保路径可被 Chromium 访问（推荐转为 base64 内联）
Python 用 weasyprint 处理纯静态 HTML 最轻量
如果 HTML 没有 JS、不依赖复杂 CSS 特性（如 Grid / Flex 容器嵌套过深、CSS 变量未降级），weasyprint 启动快、体积小、API 简单，适合服务端批量生成报表类 PDF。
- 它不执行 JS，所有动态内容必须在传入前就渲染好（服务端模板渲染完再给它）
- CSS 支持有限：不支持
position: sticky、部分伪类（:hover无效）、transform可能偏移 - 中文支持靠系统字体配置，Linux 上常需手动装
fonts-noto-cjk并在代码里指定：font_config.add_font(...) - 错误信息很直白，比如
Failed to load stylesheet就是 CSS 路径 404，别猜
vh/vw 单位、外链资源全部转相对路径或内联、所有字体显式声明 fallback。这些细节不提前理清，换十个工具都救不回一页错位的 PDF。 
