Poppler - 1. 安装和基本语法

1. windows 系统安装 Poppler

  • 参考 pdf2image 帮助文档 安装 poppler(添加 PATH 并测试是否成功)
  • pip 安装 pip install pdf2image pillow
  • pdf2image 只是调用 poppler 中的 pdftoppm 命令,所以需要安装 poppler 并添加到 PATH 中

2. 编写 Python 代码来将 PDF 转换为高质量的 JPG

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
from pdf2image import convert_from_path
import os

def pdf_to_jpg(pdf_path, dpi=300):
"""
将PDF文件转换为JPG图片,并保存在同一目录下,文件名为原文件名加上.jpg。

pdf_path: PDF文件路径
dpi: 图片的DPI,越高越清晰,默认300
"""
# 获取PDF文件所在的目录和文件名
dir_path, file_name = os.path.split(pdf_path)
base_name = os.path.splitext(file_name)[0] # 去除文件扩展名

# 使用convert_from_path将PDF转换为图片
images = convert_from_path(pdf_path, dpi=dpi)

# 只处理PDF的第一页并保存为JPG
output_path = os.path.join(dir_path, f"{base_name}.jpg")
images[0].save(output_path, 'JPEG')

print(f"转换完成:{output_path}")

# 示例使用
pdf_path = 'a.pdf' # 当前路径下的PDF文件
pdf_to_jpg(pdf_path, dpi=300)

或者如下修改上述代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
from pdf2image import convert_from_path
import os
import argparse


def pdf_to_jpg(pdf_path, dpi=300):
"""
将 PDF 文件的第一页转换为 JPG 图片,并保存在同一目录下,
文件名为原文件名加上 .jpg。

pdf_path: PDF 文件路径
dpi: 图片的 DPI,越高越清晰,默认 300
"""
# 获取 PDF 文件所在目录和文件名
dir_path, file_name = os.path.split(pdf_path)
base_name = os.path.splitext(file_name)[0] # 去除扩展名

# 将 PDF 转为图片列表
images = convert_from_path(pdf_path, dpi=dpi)

# 只保存第一页为 JPG
output_path = os.path.join(dir_path if dir_path else ".", f"{base_name}.jpg")
images[0].save(output_path, "JPEG")

print(f"转换完成:{output_path}")


def main():
parser = argparse.ArgumentParser(
description="将 PDF 的第一页转换为同名 JPG 图片"
)
# 必选参数:PDF 文件路径
parser.add_argument("pdf_path", help="要转换的 PDF 文件路径")
# 可选参数:dpi
parser.add_argument(
"--dpi",
type=int,
default=300,
help="输出图片 DPI(默认:300)"
)

args = parser.parse_args()

pdf_to_jpg(args.pdf_path, dpi=args.dpi)


if __name__ == "__main__":
main()

这样就可以命令行执行格式转换,例如

1
python pdf_to_jpg.py a.pdf --dpi 300
会在同目录下生成 a.jpg,并且 a.jpgdpi (清晰度)为 300


Poppler - 1. 安装和基本语法
http://yylustb.github.io/2025/11/20/software/Poppler/Poppler_1/
作者
yylustb
发布于
2025年11月20日
许可协议