wkhtmltopdf 跨平台安装配置指南:Linux/Windows/macOS
关于 wkhtmltopdf
wkhtmltopdf 是一款将 HTML 网页转换为 PDF 文档的命令行工具,它使用 QT Webkit 渲染引擎,完全"无头"运行,不需要显示界面。该工具广泛应用于报表生成、文档转换等场景,支持 HTML/CSS 标准,转换质量高且速度快。
全平台安装指南
Windows 系统
- 访问项目仓库下载对应安装包。
- 选择适合你系统的版本(64 位或 32 位)。
- 双击安装文件,按照向导完成安装。
- 安装完成后,打开命令提示符,输入以下命令验证:
wkhtmltopdf --version
macOS 系统
使用 Homebrew 安装(推荐):
brew install wkhtmltopdf
或者手动安装:
- 下载 macOS 安装包。
- 打开下载的.pkg 文件,按照安装向导操作。
- 打开终端,输入以下命令验证:
wkhtmltopdf --version
Linux 系统
Debian/Ubuntu 系统
# 对于 Ubuntu 22.04/Debian 11
wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-1/wkhtmltox_0.12.6.1-1.jammy_amd64.deb
sudo dpkg -i wkhtmltox_0.12.6.1-1.jammy_amd64.deb
sudo apt-get install -f
CentOS/RHEL 系统
# 对于 CentOS 8
wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-1/wkhtmltox-0.12.6.1-1.almalinux8.x86_64.rpm
sudo rpm -ivh wkhtmltox-0.12.6.1-1.almalinux8.x86_64.rpm
注意:具体版本号请以官方发布页为准。
验证安装
成功安装后,可以通过以下方法验证:
- 查看版本信息
wkhtmltopdf --version
- 生成测试 PDF
wkhtmltopdf https://www.example.com test.pdf
- 查看帮助文档
wkhtmltopdf --help
快速入门
将网页转换为 PDF:
wkhtmltopdf https://www.example.com output.pdf
将本地 HTML 文件转换为 PDF:

