Python实现多文件夹同名PDF自动合并工具

1. 项目背景与需求解析

在日常办公和文档处理中，我们经常会遇到这样的场景：多个文件夹中存放着名称相同但内容不同的PDF文件，需要按照特定顺序将它们合并为一个完整的PDF文档。这种情况常见于：

• 多部门协作项目中，各部门提交的同名报告
• 不同版本迭代的设计文档
• 分章节撰写的论文或书籍
• 按日期分类的同名报表文件

传统的手动合并方式存在几个痛点：

1. 需要逐个打开文件夹查找文件
2. 同名文件容易被覆盖
3. 合并顺序难以精确控制
4. 重复操作耗时耗力

这个项目就是要解决这些痛点，实现：

• 自动识别不同文件夹下的同名PDF
• 按照用户指定的文件夹顺序合并
• 保留原始文件结构不破坏
• 生成一个完整有序的最终PDF

2. 技术方案设计

2.1 核心功能拆解

要实现这个工具，需要解决以下几个技术关键点：

1. 文件夹遍历与文件识别

   • 递归扫描指定文件夹及其子文件夹
   • 建立文件名与路径的映射关系
   • 识别同名但不同路径的PDF文件

2. 用户交互与顺序指定

   • 提供GUI或命令行界面选择文件夹
   • 记录用户选择文件夹的顺序
   • 支持顺序调整和预览

3. PDF合并引擎

   • 按指定顺序读取PDF文件
   • 保持原始页面格式不变
   • 处理可能的加密或特殊格式

4. 输出与错误处理

   • 生成合并后的PDF文件
   • 处理合并过程中的异常情况
   • 提供合并日志和错误报告

2.2 技术选型建议

基于Python生态的方案具有明显优势：

python复制# 核心依赖库
import os
from PyPDF2 import PdfMerger
import tkinter as tk  # 用于GUI界面
from tkinter import filedialog

选择PyPDF2库的原因：

• 轻量级且功能完备
• 支持PDF1.7标准
• 良好的页面保留能力
• 活跃的社区支持

3. 详细实现步骤

3.1 环境准备与依赖安装

首先确保Python环境（建议3.7+）并安装必要依赖：

bash复制pip install PyPDF2

对于需要GUI界面的情况：

bash复制pip install tk

3.2 核心代码实现

3.2.1 文件夹选择与顺序记录

python复制def select_folders():
    root = tk.Tk()
    root.withdraw()  # 隐藏主窗口
    
    folders = []
    while True:
        folder = filedialog.askdirectory(title="选择文件夹（取消结束选择）")
        if not folder:
            break
        folders.append(folder)
    return folders

3.2.2 PDF文件收集与整理

python复制def collect_pdfs(folders):
    pdf_map = {}  # 文件名: [按顺序排列的完整路径]
    
    for folder in folders:
        for root, _, files in os.walk(folder):
            for file in files:
                if file.lower().endswith('.pdf'):
                    if file not in pdf_map:
                        pdf_map[file] = []
                    pdf_map[file].append(os.path.join(root, file))
    return pdf_map

3.2.3 PDF合并核心逻辑

python复制def merge_pdfs(pdf_map, output_path):
    merger = PdfMerge