Python结合PyQt5开发一个PDF批量合并工具
日常工作中经常需要把多个 PDF 合并成一个？网上的在线工具要么有广告、要么有页数限制、要么担心隐私泄漏。今天我们就用 Python + PyQt5 从零打造一款本地运行、无广告、无限制的 PDF 批量合并工具！
一、为什么要自己做？
市面上的 PDF 合并方案大致分三类：
| 方案 | 缺点 |
|---|---|
| 在线网站（如 SmallPDF） | 文件上传有大小限制，隐私风险 |
| Adobe Acrobat | 正版昂贵，杀鸡焉用牛刀 |
| 命令行脚本 | 对非技术用户不友好 |
我们的目标：一个有图形界面、支持拖拽、本地运行的小工具。
二、技术选型
| 需求 | 选型 | 理由 |
|---|---|---|
| GUI 框架 | PyQt5 | 成熟稳定，跨平台，控件丰富 |
| PDF 操作 | PyPDF2 | 轻量级，合并功能完善，纯 Python |
| 多线程 | QThread | 与 PyQt5 完美配合，避免界面冻结 |
三、安装依赖
pip install PyQt5 PyPDF2
或者使用 requirements.txt：
pip install -r requirements.txt
四、整体架构设计
程序分为 3 个核心模块：
pdf_merger.py
├── MergeWorker — 后台合并线程
├── DragDropListWidget — 支持拖拽的文件列表控件
└── PDFMergerApp — 主窗口（界面 + 业务逻辑）
数据流
用户操作 → 添加文件到列表 → 点击合并
↓
启动 MergeWorker 线程
↓
逐个 append PDF → 写入输出文件
↓
信号通知主线程 → 更新日志和进度条
五、核心代码详解
5.1 后台合并线程 — MergeWorker
为什么要用线程？因为如果在主线程中执行 IO 密集的合并操作，界面会"假死"。PyQt5 的 QThread 配合信号（Signal）可以完美解决：
class MergeWorker(QThread):
log_signal = pyqtSignal(str) # 日志消息
progress_signal = pyqtSignal(int) # 进度百分比
finished_signal = pyqtSignal(bool, str) # 完成状态
def __init__(self, file_list, output_path):
super().__init__()
self.file_list = file_list
self.output_path = output_path
def run(self):
merger = PdfMerger()
total = len(self.file_list)
try:
for idx, fpath in enumerate(self.file_list, 1):
self.log_signal.emit(f"[{idx}/{total}] 正在添加: {os.path.basename(fpath)}")
merger.append(fpath)
self.progress_signal.emit(int(idx / total * 100))
merger.write(self.output_path)
merger.close()
self.finished_signal.emit(True, self.output_path)
except Exception as e:
self.finished_signal.emit(False, str(e))
关键点：
- 定义了三个信号：日志、进度、完成状态
run()方法在子线程执行，通过信号回传到主线程更新 UI- 使用
try/except捕获异常，合并失败不会崩溃
5.2 拖拽列表控件 — DragDropListWidget
PyQt5 的 QListWidget 本身不支持从系统拖入文件，我们需要重写几个事件：
class DragDropListWidget(QListWidget):
files_dropped = pyqtSignal(list) # 拖入的路径列表
def __init__(self, parent=None):
super().__init__(parent)
self.setAcceptDrops(True)
self.setDragDropMode(QAbstractItemView.InternalMove)
def dragEnterEvent(self, event):
if event.mimeData().hasUrls():
event.acceptProposedAction()
else:
super().dragEnterEvent(event)
def dropEvent(self, event):
if event.mimeData().hasUrls():
paths = [url.toLocalFile() for url in event.mimeData().urls() if url.toLocalFile()]
self.files_dropped.emit(paths)
event.acceptProposedAction()
else:
super().dropEvent(event)
关键点：
setAcceptDrops(True)允许接受外部拖拽setDragDropMode(InternalMove)同时支持列表内部拖拽排序dragEnterEvent判断拖入的是否为文件 URLdropEvent提取本地路径，发射自定义信号
5.3 主窗口 — PDFMergerApp
主窗口负责布局和业务逻辑。核心布局结构：
QMainWindow
└── QVBoxLayout (根布局)
├── QLabel (标题)
├── QLabel (副标题)
├── QSplitter (垂直分割)
│ ├── QGroupBox — 文件列表区
│ │ ├── DragDropListWidget
│ │ └── QHBoxLayout — 按钮行
│ └── QGroupBox — 日志区
│ └── QTextEdit
├── QProgressBar (进度条)
└── QPushButton (合并按钮)
文件收集逻辑
支持同时传入文件和文件夹，递归收集所有 PDF：
def _collect_pdfs(self, paths):
pdfs = []
for p in paths:
if os.path.isfile(p) and p.lower().endswith(".pdf"):
pdfs.append(p)
elif os.path.isdir(p):
for root, _, files in os.walk(p):
for f in sorted(files):
if f.lower().endswith(".pdf"):
pdfs.append(os.path.join(root, f))
return pdfs
去重添加
同一个文件不会被重复添加：
def _add_to_list(self, new_files):
added = 0
for f in new_files:
if f not in self.pdf_files:
self.pdf_files.append(f)
self.file_list_widget.addItem(f)
added += 1
列表排序
上移/下移通过交换列表中的位置实现：
def _move_up(self):
row = self.file_list_widget.currentRow()
if row > 0:
item = self.file_list_widget.takeItem(row)
self.file_list_widget.insertItem(row - 1, item)
self.file_list_widget.setCurrentRow(row - 1)
self.pdf_files[row], self.pdf_files[row - 1] = (
self.pdf_files[row - 1], self.pdf_files[row]
)
六、样式美化
使用 Qt StyleSheet（类似 CSS）统一美化控件：
QMainWindow {
background-color: #f5f7fa;
}
QGroupBox {
border: 1px solid #dcdfe6;
border-radius: 8px;
background-color: #ffffff;
}
#mergeBtn {
background-color: #3498db;
color: white;
font-size: 15px;
font-weight: bold;
border-radius: 8px;
}
QProgressBar::chunk {
background: qlineargradient(x1:0, y1:0, x2:1, y2:0,
stop:0 #3498db, stop:1 #2ecc71);
border-radius: 5px;
}美化要点：
QGroupBox使用白色背景 + 圆角，呈现卡片效果- 合并按钮使用蓝色主题色，hover 和 pressed 有层次感
- 进度条渐变色（蓝 → 绿），视觉上更有活力
- 字体使用
Microsoft YaHei，中文显示清晰美观
七、使用流程
第一步：启动程序
python pdf_merger.py
第二步：添加文件
三种方式任选：
- 拖拽：直接从文件资源管理器拖入 PDF 文件或文件夹
- 添加文件：点击按钮，在文件选择对话框中多选 PDF
- 添加目录：点击按钮，选择一个文件夹，自动扫描其中所有 PDF
第三步：调整顺序
- 选中某个文件，用 ⬆/⬇ 按钮调整位置
- 或者直接在列表中拖拽排序
第四步：点击合并
- 点击 “🚀 开始合并”
- 选择保存位置和文件名
- 等待完成，日志区实时显示处理进度
八、可能遇到的问题与解决
1. 安装 PyQt5 失败
# 尝试使用国内镜像 pip install PyQt5 -i https://pypi.tuna.tsinghua.edu.cn/simple
2. 合并时报错 “PdfReadError”
通常是因为 PDF 文件损坏或加密。解决方法：
- 排除问题文件（可在日志中看到是哪个文件报错）
- 使用其他工具先修复或解密该 PDF
3. 打包为 EXE
想分发给没有 Python 环境的同事？使用 PyInstaller：
pip install pyinstaller pyinstaller --onefile --windowed --name "PDF合并工具" pdf_merger.py
打包后的 EXE 位于 dist/ 目录。
九、进阶扩展思路
如果你想继续完善这个工具，以下是一些扩展方向：
| 方向 | 说明 |
|---|---|
| 支持加密 PDF | 在 append 前使用 PdfReader 解密 |
| 选择页面范围 | 允许用户选择每个 PDF 的特定页面 |
| 预览功能 | 使用 pdf2image 生成缩略图预览 |
| 保存/加载配置 | 记住上次的文件列表和输出路径 |
| 多语言 | 使用 Qt 的 i18n 机制支持英文等 |
| 打包发布 | 使用 PyInstaller / Nuitka 打包为单文件 EXE |
十、完整项目结构
19-批量PDF合并工具/
├── pdf_merger.py # 主程序源码
├── requirements.txt # 依赖清单
├── README.md # 项目说明
└── blog.md # 本篇开发博客
总结
通过这篇文章，我们从零实现了一个功能完整的 PDF 批量合并工具：
- PyPDF2 负责 PDF 的读取与合并
- PyQt5 构建了美观的图形界面
- QThread 保证了合并过程中界面不冻结
- 拖拽功能 让操作更加便捷
- QSS 样式 让界面更加美观
整个项目只有一个 Python 文件，代码约 300 行，简洁易懂。希望这个小工具能帮到你，也希望这篇教程能给你一些 PyQt5 桌面开发的启发！
到此这篇关于Python结合PyQt5开发一个PDF批量合并工具的文章就介绍到这了,更多相关Python批量合并PDF内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
今天小编就为大家分享一篇对python中词典的values值的修改或新增KEY详解，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2019-01-01
这篇文章主要介绍了Python设计模式之建造者模式,简单说明了建造者模式的概念、原理,并结合实例形式分析了Python定义及使用建造者模式相关操作技巧,需要的朋友可以参考下2019-01-01
这篇文章主要为大家详细介绍了python实现聚类算法原理，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2018-02-02
下面小编就为大家分享一篇python 拷贝特定后缀名文件,并保留原始目录结构的实例，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2018-04-04
numpy库ndarray多维数组的维度变换方法(reshape、resize、swapaxes、flatten)
这篇文章主要介绍了numpy库ndarray多维数组的维度变换方法(reshape、resize、swapaxes、flatten)，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2020-04-04
这篇文章主要为大家详细介绍了python实现自动解数独小程序，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2019-01-01
这篇文章主要为大家详细介绍了python实现简易五子棋游戏，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2022-05-05
这篇文章主要介绍了Python函数定义及传参方式详解(4种)，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2019-03-03
这篇文章主要介绍了Python爬取365好书中小说代码实例,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2020-02-02
这篇文章主要为大家详细介绍了如何使用Python的wxPython库结合JSON配置文件,开发一个支持动态按钮创建,文件执行和配置管理的桌面应用程序,感兴趣的可以了解下2025-04-04
最新评论