如何安装wkhtmltopd 0.12.5

# 如何安装wkhtmltopdf 0.12.5 ## 前言 wkhtmltopdf是一个开源的命令行工具，用于将HTML文档转换为PDF格式。它基于Qt WebKit渲染引擎，支持复杂的CSS、JavaScript和SVG内容。0.12.5版本是一个经典稳定版本，虽然目前已不是最新版，但仍在许多生产环境中广泛使用。 本文将详细介绍在Linux、Windows和macOS系统上安装wkhtmltopdf 0.12.5的具体步骤，以及常见问题的解决方法。 --- ## 一、Linux系统安装 ### 1. Ubuntu/Debian系统 #### 方法1：通过APT仓库安装 ```bash # 添加依赖库 sudo apt-get update sudo apt-get install xfonts-75dpi xfonts-base # 下载0.12.5版本的deb包 wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox_0.12.5-1.bionic_amd64.deb # 安装deb包 sudo dpkg -i wkhtmltox_0.12.5-1.bionic_amd64.deb sudo apt-get install -f # 修复依赖 

方法2：从源码编译（适用于定制需求）

sudo apt-get install qt5-default libqt5webkit5-dev g++ build-essential wget https://github.com/wkhtmltopdf/wkhtmltopdf/archive/0.12.5.tar.gz tar -xzvf 0.12.5.tar.gz cd wkhtmltopdf-0.12.5 qmake && make sudo make install 

2. CentOS/RHEL系统

# 安装依赖 sudo yum install xorg-x11-fonts-75dpi xorg-x11-fonts-Type1 # 下载RPM包 wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox-0.12.5-1.centos7.x86_64.rpm # 安装 sudo rpm -Uvh wkhtmltox-0.12.5-1.centos7.x86_64.rpm 

---

二、Windows系统安装

1. 图形界面安装

1. 访问官方Release页面
2. 下载wkhtmltox-0.12.5-1.msvc2015-win64.exe（64位）或wkhtmltox-0.12.5-1.msvc2015-win32.exe（32位）
3. 双击运行安装向导，按提示完成安装
4. 将安装目录（如C:\Program Files\wkhtmltopdf\bin）添加到系统PATH环境变量

2. 命令行验证安装

wkhtmltopdf --version # 应显示：wkhtmltopdf 0.12.5 (with patched qt) 

---

三、macOS系统安装

1. 使用Homebrew安装

brew tap homebrew/cask brew install --cask wkhtmltopdf 

2. 手动安装

# 下载macOS专用包 curl -LO https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox-0.12.5-1.macos-cocoa.pkg # 安装 sudo installer -pkg wkhtmltox-0.12.5-1.macos-cocoa.pkg -target / 

---

四、验证安装

所有平台通用验证命令：

wkhtmltopdf --version wkhtmltoimage --version 

测试PDF生成：

wkhtmltopdf https://www.example.com example.pdf 

---

五、常见问题解决

1. 字体显示异常

解决方法： - Linux：安装中文字体包sudo apt-get install fonts-wqy-zenhei - Windows：确保系统字体目录包含所需字体

2. 出现段错误(Segmentation Fault)

原因：常见于0.12.5版本的已知问题 解决方案：

# 添加--disable-smart-shrinking参数 wkhtmltopdf --disable-smart-shrinking input.html output.pdf 

3. 无法渲染JavaScript

解决方法：

wkhtmltopdf --enable-javascript --no-stop-slow-scripts page.html output.pdf 

4. 代理设置

wkhtmltopdf --proxy http://proxy:port http://example.com output.pdf 

---

六、卸载方法

Linux

sudo apt-get remove wkhtmltopdf # Debian/Ubuntu sudo yum remove wkhtmltopdf # CentOS/RHEL 

Windows

通过控制面板的”卸载程序”功能移除

macOS

sudo rm -rf /usr/local/bin/wkhtmltopdf sudo rm -rf /usr/local/share/wkhtmltopdf 

---

结语

wkhtmltopdf 0.12.5虽然已不是最新版本，但其稳定性和兼容性仍使其成为许多项目的首选。通过本文的详细指导，您应该能在各种操作系统上顺利完成安装。如需更高版本的功能，建议参考官方文档升级到新版本。

注意：生产环境建议使用Docker镜像madnight/docker-alpine-wkhtmltopdf以获得更好的隔离性和一致性。 “`

本文共计约1200字，涵盖了主流操作系统的安装方法、验证步骤和常见问题解决方案，采用Markdown格式编写，可直接用于技术文档发布。