最稳定方案是用wkhtmltopdf命令行直接传入多个绝对路径HTML文件；需确保每页结构完整、UTF-8无BOM、动态内容加--javascript-delay；pdfkit要注意路径编码与字符集；前端拼接或打印均不可靠，Puppeteer更准但更重。
用 wkhtmltopdf 合并多页 HTML 到单个 PDF
最稳定、可控的方案是用命令行工具 wkhtmltopdf 直接传入多个 HTML 文件路径，它会按顺序拼成一页 PDF。不是靠前端 JS 拼接，也不是靠浏览器打印——那些方式容易分页错乱、样式丢失、跨域失败。
常见错误现象：wkhtmltopdf 报 Exit with code 1 due to network error，通常是某页 HTML 中引用了本地 file:// 资源或未启动本地 HTTP 服务；还有人把多个 页面直接用 cat a.html b.html > all.html 硬拼，结果标签嵌套崩溃，PDF 渲染为空白。
- 确保所有 HTML 文件路径为绝对路径（相对路径在批量时极易出错）
- 每页 HTML 必须是完整、可独立打开的文档（含
结构） - 若页面含 AJAX 或动态渲染内容，需加
--javascript-delay 2000等待加载完成 - 推荐加
--page-size A4 --margin-top 20 --margin-bottom 20统一版式
wkhtmltopdf \ --page-size A4 \ --margin-top 20 --margin-bottom 20 \ --javascript-delay 1500 \ /path/to/page1.html \ /path/to/page2.html \ /path/to/page3.html \ output.pdf
pdfkit（Python）合并 HTML 列表时的路径与编码陷阱
pdfkit 是 wkhtmltopdf 的 Python 封装，用起来像写代码，但默认不自动处理中文路径和 UTF-8 内容。你传入一个 list，它内部仍调用 wkhtmltopdf 命令行，所以底层限制完全一致。
典型翻车点：用 pdfkit.from_file(['a.html', 'b.html'], 'out.pdf')，结果 PDF 只有第一页，后面全空——大概率是其中某个 HTML 文件用了 charset=gb2312 但没声明 meta，或文件路径含中文没做 urllib.parse.quote 编码。
立即学习“前端免费学习笔记（深入）”；
网页中拖动 DIV 是很常见的操作，今天就分享给大家一个 jQuery 多列网格拖动布局插件，和其它的插件不太一样的地方在于你处理拖放的元素支持不同大小，并且支持多列的网格布局，它们会自动的根据位置自己排序和调整。非常适合你开发具有创意的应用。这个插件可以帮助你将任何的 HTML 元素转换为网格组件
- HTML 文件必须保存为 UTF-8 无 BOM 格式（VS Code / Sublime 默认可能带 BOM）
- 路径含空格或中文时，改用
pdfkit.from_url()+ 本地起一个http.server更可靠 - 不要依赖
options里的encoding参数，它只影响请求头，不解决文件读取编码 - 调试时加
verbose=True查看真实执行的命令行，比看 Python 异常有用得多
浏览器打印（window.print()）无法真正“合并”多页 HTML
有人想用 JS 把多个 HTML fetch 过来、拼进一个 再调 print()，这本质上不是合并 PDF，只是让浏览器尝试渲染一个超长页面。结果往往：分页线错位、CSS @media print 失效、背景图被禁、页眉页脚重叠、Chrome 打印预览卡死。
更隐蔽的问题是：现代浏览器对跨域 iframe 的 contentDocument 访问做了严格限制，即使同域，如果某页启用了 X-Frame-Options: DENY 或 Content-Security-Policy: frame-ancestors 'none'，JS 就根本读不到内容。
-
window.print()是用户端行为，不能服务端触发，也不生成二进制 PDF 流 - 所谓“前端生成 PDF”库（如
jsPDF+html2canvas）实际是截图合成，文字不可选、缩放糊、分页手动算、性能差 - 如果业务真要“前端一键导出多页 PDF”，唯一可行路径是：前端发请求到后端，后端用
wkhtmltopdf或类似服务生成，再返回 PDF 文件流
为什么不用 Puppeteer？它比 wkhtmltopdf 更重但更准
当你的 HTML 重度依赖现代 CSS（比如 grid、subgrid）、Web Components 或复杂动画时，wkhtmltopdf（基于 QtWebkit）会挂掉或渲染异常。puppeteer 基于 Chromium，兼容性好，还能精确控制每页插入分页符（page.pdf({omitBackground: false}) + document.body.style.pageBreakAfter = 'always'）。
代价是：启动慢、内存高、部署麻烦（得装 Chromium）、并发导出需池化管理。而且它不会自动“合并多个 HTML 文件”，你得自己 fs.readFileSync 拼字符串，或逐个 goto 再 pdf() 后合并二进制流（要用 pdf-lib 或系统 pdftk）。
- 不要在 Puppeteer 中用
page.setContent(html)直接塞多页 HTML 字符串——CSS 作用域混乱，重复注入 - 正确做法：用
page.goto('file:///.../page1.html')→page.pdf()→ 保存临时 PDF；循环；最后用pdf-lib合并 - 关键细节：
page.pdf()的printBackground: true必须显式开启，否则背景色/图全丢
