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：
wkhtmltopdf input.html output.pdf
自定义页面大小和方向：
wkhtmltopdf --page-size A4 --orientation Landscape input.html output.pdf
常见问题解决
Q: 中文显示乱码怎么办？
A: 安装中文字体包，如：
sudo apt-get install fonts-wqy-zenhei # Debian/Ubuntu
Q: Linux 系统安装时提示缺少依赖？
A: 尝试使用以下命令解决依赖问题：
sudo apt-get -f install # Debian/Ubuntu
sudo yum install -y fontconfig libX11 libXext libXrender libjpeg libpng # CentOS/RHEL
总结
通过上述方法，你已经成功安装并开始使用 wkhtmltopdf。这是一个功能强大的 HTML 转 PDF 工具，掌握它将极大提高你的工作效率。
