如何安装wkhtmltopd 0.12.5

发布时间：2021-07-07 14:37:49 作者：chen
来源：亿速云阅读：169

# 如何安装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. 图形界面安装

访问官方Release页面
下载wkhtmltox-0.12.5-1.msvc2015-win64.exe（64位）或wkhtmltox-0.12.5-1.msvc2015-win32.exe（32位）
双击运行安装向导，按提示完成安装
将安装目录（如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格式编写，可直接用于技术文档发布。