wkhtmltopdf HTML转PDF 实战指南从 HTML 文件到成品 PDF【免费下载链接】wkhtmltopdfConvert HTML to PDF using Webkit (QtWebKit)项目地址: https://gitcode.com/gh_mirrors/wk/wkhtmltopdfwkhtmltopdf 是一款基于 QT Webkit 渲染引擎的无头命令行工具用于把 HTML 转 PDF不需要任何显示界面。本文覆盖安装、单页转换、页面参数、页眉页脚和批量处理看完可以直接跑通并自行处理常见报错。项目速览wkhtmltopdf 用 QT Webkit 引擎把 HTML 渲染成 PDF配套的wkhtmltoimage还能输出图片全程 headless 运行。功能边界支持 HTML/CSS、页眉页脚、目录和 PDF 书签底层是 2016 年前后的 Webkit依赖非常新的 CSS 特性的页面可能渲染不一致。适合固定版式的报表、文档转换、CI 批量出件不适合要求最新浏览器引擎的场景。官方说明README.md最短上手路径从官方发布页下载与你发行版对应的wkhtmltox二进制包对照表见 docs/downloads.md装上后验证直接贴命令就行# Debian/Ubuntu 22.04 示例替换成你发行版的文件名 sudo dpkg -i wkhtmltox_0.12.6.1-2.jammy_amd64.deb sudo apt-get install -f wkhtmltopdf --version # 输出 0.12.6 即安装成功核心操作常见 HTML 转 PDF 场景转换单页wkhtmltopdf input.html output.pdf # 第一个参数是输入最后一个是输出输入也可以是 URLwkhtmltopdf https://example.com output.pdf。自定义页面参数wkhtmltopdf --page-size A4 --orientation Landscape \ --margin-top 15mm --margin-left 12mm \ input.html output.pdf--page-size支持 A3、Letter 等--orientation只有 Portrait 和 Landscape 两个值页边距默认 10mm可用-B -L -R -T短参数分别设置。页眉页脚与页码wkhtmltopdf --header-right Page [page] of [topage] \ --footer-center [date] input.html output.pdf[page]、[topage]是占位符会替换为当前页码和总页数还支持[webpage]、[title]等变量。目录与批量处理wkhtmltopdf toc input.html output.pdf # 根据 h 标签在文档开头插入目录页面较多时把每行一组参数喂给 stdin可以复用同一个进程比循环调用快不少echo a.html a.pdf | wkhtmltopdf --read-args-from-stdin各平台差异点平台差异操作备注Linux (Debian/Ubuntu)安装对应发行版的 wkhtmltox.deb需 fontconfig 等系统依赖包列表见 docs/downloads.mdLinux (RHEL/CentOS/Alma)安装对应发行版的.rpm同 Debian按发行版选包Windows7z 压缩包解压后把目录加入 PATH.exe安装器会自动写入 PATHmacOS双击.pkg安装二进制位于/usr/local/bin无额外依赖排错速查报错关键词/现象原因解决命令或操作wkhtmltopdf: command not found未加入 PATH常见于 7z 解压版把二进制目录加入 PATH或改装.exe安装器Cannot connect to X11 server用了发行版源里未修补的包需要 X 服务器sudo apt-get install xvfb再用xvfb-run wkhtmltopdf ...运行中文显示为方框乱码系统缺少 CJK 字体sudo apt-get install fonts-wqy-zenhei fc-cachedpkg 提示依赖缺失.deb依赖未装齐sudo apt-get install -fJS 内容没渲染出来页面脚本异步加载渲染时机过早追加参数--javascript-delay 1000延伸参考完整命令行参数docs/usage/wkhtmltopdf.txt各平台安装包对照表docs/downloads.md项目状态与 patched Qt 背景docs/status.md如果你需要在 CI 或脚本里批量生成 PDF这套无头 HTML 转 PDF 流程可以直接落进生产环境使用。【免费下载链接】wkhtmltopdfConvert HTML to PDF using Webkit (QtWebKit)项目地址: https://gitcode.com/gh_mirrors/wk/wkhtmltopdf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
