问题

Python 中 PDF 转图片一般用的是 pdf2image。有时我们会发现 PDF 转出来的图片都是空白，或者缺失了一些字，具体表现就是一些应该有字的区域是空白。

由于某些原因我不能把出现问题的文件放上来，不过大致就是这个情况。

主要的代码如下：

images = pdf2image.convert_from_path('/path/to/pdf', output_folder='images/', fmt='jpg')

运行时可能会发现代码没有任何异常，但是结果不对。

分析和解决

其实 pdf2image 底层默认使用的是 pdftoppm 来转图片，我们可以直接使用其来测试有问题的 PDF，会发现输出了一些警告：

除 pdftoppm 外，pdf2image 在两种情况下会使用 pdftocairo 来转图片，具体是：

当要转成 tif/tiff 格式时

当 transparent=True（默认为 False）且要转成 png/tif/tiff 时

Missing language pack for 'Adobe-GB1' mapping

很明显是缺失了语言包。

而且字缺失，自然而然想到的是字体缺失，即系统中没有 PDF 中的字体。

我们需要找到对应的字体，然后安装上。

一般来说，Linux 系统中，直接复制相应的字体文件到 /usr/share/fonts/ 目录下即可，可以使用 fc-list :lang=zh-cn 来查看当前系统有哪些中文字体。

对于中文来说，Noto CJK 字体可以覆盖所有的字，可以尝试下载安装此字体，有些系统可能自带。

有了字体，你再试的时候可能会发现还是不行，因为你还需要另一个东西：poppler-data。

这个东西是干嘛用的？根据作者的描述：

This package consists of encoding files for use with poppler. The encoding files are optional and poppler will automatically read them if they are present. When installed, the encoding files enables poppler to correctly render CJK and Cyrrilic properly. While poppler is licensed under the GPL, these encoding files have different license, and thus distributed separately.

大致就是这个包里是一些编码文件，可以让 poppler 正确渲染 CJK 文字。

我们可以通过 apt 来安装：

sudo apt install poppler-data

然后再次尝试，应该就可以成功转成正常的图片了。

总结一下，你需要两个东西：

正确的字体文件

poppler-data

Reference

以上为个人经验，希望能给大家一个参考，也希望大家多多支持。如有错误或未考虑完全的地方，望不吝赐教。