html转PDF之wkhtmltopdf

一、概述+需求

1、如何使用程序将html转为pdf？
2、导出的pdf如何自定义页眉、页脚等参数？

解决方案：wkhtmltopdf
优势：
1、支持自定义页眉页脚页码

2、支持文本选中粘贴复制

3、支持将html的h标签自动生成pdf

劣势：
1、需要结合后端去实现生成接口返回给前端下载

2、wkhtmltopdf 使用 WebKit 渲染引擎，这意味着它在某些情况下可能无法完全支持所有现代 CSS 和 JavaScript 特性，特别是那些依赖于最新浏览器特性的功能

3、wkhtmltopdf 对 JavaScript 的支持有限。虽然它可以在某些情况下执行简单的 JavaScript，但复杂的交互式内容可能无法正确渲染。

二、部署安装

官方下载地址：wkhtmltopdf

windows系统

• 下载对应版本 解压到本地 比如：E:\Program Files\wkhtmltox\bin
• 配置PATH环境变量 增加 E:\Program Files\wkhtmltox\bin
  

centos系统

• 所需要的依赖

yum install fontconfig libX11 libXext libXrender libjpeg libpng xorg-x11-fonts-75dpi xorg-x11-fonts-Type1 -y

• 如果依赖 yum安装不上 更换阿里镜像源

#备份
cp -r /etc/yum.repos.d /etc/yum.repos.d.bak2025

#直接下载阿里云的 YUM 源配置文件来替换原有的配置：
wget -O /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.repo

#一波操作
yum clean all
yum makecache

• 下载安装

#下载
wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6-1/wkhtmltox-0.12.6-1.centos7.x86_64.rpm
#安装
rpm -ivh wkhtmltox-0.12.6-1.centos7.x86_64.rpm

若下载不下来，可联系我索要安装包（因资源重复，因此我传不上去资源）

• 查看安装状态
  

三、生成中文乱码问题处理

1、html需要设置meta

<meta http-equiv="content-type" content="text/html;charset=utf-8">

2、缺少字体

• Linux 复制 simsun.ttc 字体到 /usr/share/fonts 目录下

  • 字体文件找不到可以找我要 （因资源重复，因此我传不上去资源）

• Windows直接安装simsun.ttc字体