本文详解如何修复pdf批量合并脚本中因匹配失败导致的indexerror异常，通过健壮的文件匹配逻辑、路径拼接修正和输出命名优化，实现稳定处理数百甚至上千个pdf文件的自动化合并任务。
本文详解如何修复pdf批量合并脚本中因匹配失败导致的indexerror异常，通过健壮的文件匹配逻辑、路径拼接修正和输出命名优化，实现稳定处理数百甚至上千个pdf文件的自动化合并任务。
在使用 PyPDF2.PdfMerger 批量合并PDF时，原始代码存在三个关键缺陷：空列表越界访问、路径拼接错误、输出文件名覆盖。当 second_folder 中不存在与 first_folder 文件前缀匹配的PDF时，[f for f in second_folder if key in f][0] 会触发 IndexError: list index out of range——这正是报错的根本原因。以下为完整修复方案：
✅ 正确做法：增强鲁棒性 + 规范路径 + 保留原名
import os
from PyPDF2 import PdfMerger
def merge_pdf(first_folder, second_folder, output_folder):
# 确保输出目录存在
os.makedirs(output_folder, exist_ok=True)
# 获取PDF文件列表（含完整路径，避免后续拼接错误）
first_files = [os.path.join(first_folder, f)
for f in os.listdir(first_folder)
if f.lower().endswith('.pdf')]
second_files = [os.path.join(second_folder, f)
for f in os.listdir(second_folder)
if f.lower().endswith('.pdf')]
# 构建 second_folder 的文件名映射（提升查找效率）
second_name_map = {os.path.splitext(f)[0].lower(): f for f in os.listdir(second_folder)
if f.lower().endswith('.pdf')}
merged_count = 0
for pdf_path in first_files:
filename = os.path.basename(pdf_path)
key = os.path.splitext(filename)[0].lower() # 统一转小写，避免大小写敏感问题
# 安全匹配：优先用字典查找，避免列表遍历+索引风险
matching_draft = second_name_map.get(key)
if not matching_draft:
print(f"⚠️ 警告：未在 {second_folder} 中找到匹配 '{key}' 的PDF文件，跳过 {filename}")
continue
try:
merger = PdfMerger()
merger.append(pdf_path) # 第一个PDF
merger.append(os.path.join(second_folder, matching_draft)) # 第二个PDF
# 输出文件名 = 原始文件名（不含扩展名） + '_merged.pdf'
output_path = os.path.join(output_folder, f"{key}_merged.pdf")
merger.write(output_path)
merger.close()
merged_count += 1
print(f"✅ 已合并：{filename} + {matching_draft} → {output_path}")
except Exception as e:
print(f"❌ 合并失败 {pdf_path} 和 {matching_draft}：{e}")
# 使用示例（请替换为实际路径）
# merge_pdf(r'F:\first_folder', r'F:\second_folder', r'F:\output_folder')? 关键改进说明：
- 空匹配防御：使用 dict.get() 替代列表索引，天然规避 IndexError；
- 路径安全：全程使用 os.path.join() 拼接路径，兼容Windows/Linux；
- 命名规范：输出文件以原始主文件名命名（如 report_merged.pdf），避免全部覆盖为 merged_file.pdf；
- 大小写兼容：统一转为小写比对，防止 Report.pdf 无法匹配 report_draft.pdf；
- 错误反馈：清晰提示缺失匹配项，便于排查数据一致性问题；
- 资源释放：显式调用 merger.close()，防止文件句柄泄漏。
? 最佳实践建议：
若需模糊匹配（如 key 出现在文件名中而非完全相等），可将 second_name_map.get(key) 改为遍历 second_files 并用 key in os.path.splitext(f)[0].lower() 判断；但精确匹配性能更优，推荐预先规范命名（如 invoice_001.pdf ↔ invoice_001_draft.pdf）。
