
在日常工作中,我们经常会遇到需要对大量PDF文件进行批量操作的场景,例如为所有报告统一添加一个免责声明页,或者在文档开头插入封面页。当这些PDF文件分散在多个层级的文件夹中时,手动操作变得异常繁琐且低效。本教程旨在提供一个基于Python的高效解决方案,利用PyMuPDF库实现对指定目录下所有PDF文件的自动化页面追加与插入,尤其适用于需要定期生成和处理大量PDF文件的自动化流程。
PyMuPDF是一个功能强大且高效的Python库,用于处理PDF文档。它提供了丰富的功能,包括PDF的读取、写入、编辑、渲染等。其底层基于MuPDF库,性能卓越,尤其适合处理大量文件或在资源受限的服务器环境下运行。
在使用之前,请确保已安装PyMuPDF:
pip install PyMuPDF
本节将演示如何遍历指定根目录及其所有子目录下的PDF文件,并将一个固定的PDF页面追加到每个找到的PDF文件的末尾。
立即学习“Python免费学习笔记(深入)”;
首先,我们需要一个机制来发现所有目标PDF文件。Python的os.walk函数是遍历目录树的理想选择。然后,为了提高效率和稳定性,我们将PDF文件内容读取到内存中进行处理,而不是直接通过文件路径打开。
假设我们有一个固定的PDF页面 C:\page2.pdf 需要追加到 C:\Folders 及其子目录下的所有PDF文件中。
import fitz # PyMuPDF库
import os
import pathlib
# 定义目标根目录和要追加的页面路径
target_folder = r"C:\Folders"
page_to_add_path = r"C:\page2.pdf"
# 收集所有PDF文件路径
pdffiles = []
for root, dirs, files in os.walk(target_folder):
for name in files:
if name.endswith(".pdf"):
pdffiles.append(os.path.join(root, name))
# 打开要追加的源PDF页面
# 注意:这里只打开一次源PDF,避免重复IO操作
try:
src_page_doc = fitz.open(page_to_add_path)
except fitz.FileNotFoundError:
print(f"错误:未找到源PDF文件 '{page_to_add_path}'。请检查路径。")
exit()
except Exception as e:
print(f"打开源PDF文件时发生错误:{e}")
exit()
# 遍历并处理每个PDF文件
print(f"开始处理 {len(pdffiles)} 个PDF文件...")
for f_path in pdffiles:
try:
# 将目标PDF文件内容读取到内存中
# 这种方式对于在服务器上处理大量小文件特别有效,避免频繁的文件句柄操作
stream = pathlib.Path(f_path).read_bytes()
# 从内存中打开PDF文档
doc = fitz.open("pdf", stream)
# 将源PDF文档(这里只有一页)追加到当前文档的末尾
doc.insert_pdf(src_page_doc)
# 保存修改后的PDF,覆盖原文件
# ez_save() 方法是一个便捷的保存方式,它会尝试优化文件大小
doc.ez_save(f_path)
print(f"成功处理: {f_path}")
except fitz.EmptyFileError:
print(f"警告: 文件 {f_path} 是空的或损坏的PDF,已跳过。")
except Exception as e:
print(f"处理文件 {f_path} 时发生错误: {e}")
finally:
# 确保文档关闭,释放资源
if 'doc' in locals() and not doc.is_closed:
doc.close()
# 关闭源PDF文档
if not src_page_doc.is_closed:
src_page_doc.close()
print("所有PDF文件处理完成。")代码解析:
除了追加页面,有时我们还需要将页面插入到PDF的特定位置,例如在第一页之前插入一个封面,或在最后一页之后插入一个版权页。insert_pdf 方法提供了 start_at 参数来实现这一点。
以下示例演示如何在一个PDF文件开头插入 C:\Files\page1.pdf,并在末尾追加 C:\Files\page3.pdf。
import fitz
import os
import pathlib
# 定义目标根目录和要插入的页面路径
target_folder = r"C:\Folders"
page_before_path = r"C:\Files\page1.pdf"
page_after_path = r"C:\Files\page3.pdf"
# 收集所有PDF文件路径
pdffiles = []
for root, dirs, files in os.walk(target_folder):
for name in files:
if name.endswith(".pdf"):
pdffiles.append(os.path.join(root, name))
# 预先打开要插入的源PDF页面
try:
src1 = fitz.open(page_before_path)
src3 = fitz.open(page_after_path)
except fitz.FileNotFoundError as e:
print(f"错误:未找到源PDF文件。请检查路径:{e}")
exit()
except Exception as e:
print(f"打开源PDF文件时发生错误:{e}")
exit()
print(f"开始处理 {len(pdffiles)} 个PDF文件,插入前后页面...")
for f_path in pdffiles:
try:
stream = pathlib.Path(f_path).read_bytes()
doc = fitz.open("pdf", stream)
# 在文档的第0页(即开头)插入 src1 的所有页面
doc.insert_pdf(src1, start_at=0)
# 在文档的末尾追加 src3 的所有页面
doc.insert_pdf(src3)
doc.ez_save(f_path)
print(f"成功处理: {f_path}")
except fitz.EmptyFileError:
print(f"警告: 文件 {f_path} 是空的或损坏的PDF,已跳过。")
except Exception as e:
print(f"处理文件 {f_path} 时发生错误: {e}")
finally:
if 'doc' in locals() and not doc.is_closed:
doc.close()
# 关闭源PDF文档
if not src1.is_closed:
src1.close()
if not src3.is_closed:
src3.close()
print("所有PDF文件处理完成。")代码解析:
本教程展示了如何利用Python和PyMuPDF库,以一种高效且灵活的方式,批量管理分散在多层目录下的PDF文件。无论是简单地追加页面,还是在特定位置插入新页面,PyMuPDF都能提供稳定可靠的解决方案。通过自动化这些重复性任务,可以显著提高工作效率,尤其是在需要定期处理大量文档的场景中。记住,在任何自动化文件操作之前,做好数据备份始终是至关重要的一步。
以上就是利用Python与PyMuPDF库批量向多层目录下的PDF文件追加或插入指定页面的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号