pdfly：基于 pypdf 的命令行 PDF 瑞士军刀

在日常的开发与系统管理工作中，我们频繁地与 PDF 文档打交道。无论是技术手册、报告归档还是发票处理，PDF 都是标准格式。然而，当需要批量处理这些文档时，传统的图形用户界面（GUI）应用往往显得力不从心。逐个打开文件、点击菜单、保存，这一系列手动操作不仅效率低下，而且极易出错。对于追求自动化的开发者和系统管理员而言，一个强大、可编写脚本的命令行工具才是真正的“瑞士军刀”。

pdfly 正是为此而生的解决方案。它是一个基于广受欢迎的纯 Python PDF 处理库 pypdf 构建的命令行接口（CLI），旨在将 pypdf 强大的文档处理能力带到终端，让我们能够以脚本化的方式，优雅地完成 PDF 的合并、拆分、页面旋转、内容提取等一系列复杂操作。

认识 pdfly 及其核心引擎 pypdf

在我们深入 pdfly 的具体用法之前，有必要了解其背后的驱动力——pypdf 库。pypdf 是一个历史悠久且持续活跃的开源项目（其前身为 PyPDF2），为 Python 开发者提供了全面的 PDF 文档操作 API。它能够解析、修改和生成 PDF 文件，功能覆盖了从基础的元数据读写到复杂的页面变换与内容提取。

pdfly 的设计哲学，就是将这些 Python API 调用抽象为简洁的命令行指令。这意味着，你无需编写完整的 Python 脚本，就能直接在 Shell 环境中调用 pypdf 的核心功能。这种设计模式极大地降低了使用门槛，同时保留了命令行工具固有的可组合性与自动化潜力。

安装 pdfly 非常简单，因为它作为 pypdf 的一部分被分发。只需通过 pip 安装 pypdf 库，pdfly 命令便会自动安装到你的系统中：

pip install pypdf

安装完成后，你就可以在终端中通过 pdfly --version 来验证其是否成功安装。

pdfly 的核心功能与脚本化实践

pdfly 的强大之处在于其能够轻松集成到自动化脚本中，替代人工操作。让我们通过几个常见的场景，一窥其在实际工作流中的应用潜力。虽然 pdfly 的命令非常直观，但理解其操作背后的 pypdf 实现，能让我们更深刻地把握其能力边界。

1. 合并多个 PDF 文档

场景：你需要将一个项目的所有周报（每周一个 PDF）合并成一份季度总结报告。

使用 GUI 工具，你需要依次打开文件，然后拖拽页面或使用合并功能。而 pdfly 能够用一行命令解决问题。其底层逻辑对应于 pypdf 的 PdfWriter 对象，它能将来自不同 PdfReader 对象的页面逐一添加进来。

pypdf 实现逻辑：

# 假设有 'week1.pdf', 'week2.pdf', ..., 'week12.pdf'
from pypdf import PdfWriter

merger = PdfWriter()

for pdf_file in ["week1.pdf", "week2.pdf", "week3.pdf"]:
    merger.append(pdf_file)

merger.write("quarterly_report.pdf")
merger.close()

通过 pdfly，这个过程被简化为类似 pdfly merge week*.pdf -o quarterly_report.pdf 的命令，能够无缝地与 Shell 的通配符结合，实现高效的批量合并。

2. 旋转与修正页面方向

场景：扫描的文档中，部分页面方向错误，需要顺时针旋转 90 度进行修正。

手动修正这类问题尤为繁琐。pypdf 库允许我们对单个页面对象执行旋转操作。

pypdf 实现逻辑：

from pypdf import PdfReader, PdfWriter

reader = PdfReader("scanned_doc.pdf")
writer = PdfWriter()

# 仅旋转第一页
page = reader.pages[0]
page.rotate(90)  # 顺时针旋转90度
writer.add_page(page)

# 添加其余页面
for i in range(1, len(reader.pages)):
    writer.add_page(reader.pages[i])

with open("fixed_doc.pdf", "wb") as output_pdf:
    writer.write(output_pdf)

pdfly 为此提供了页面范围选择语法，你可以精确指定要操作的页面，例如 pdfly rotate 1 --clockwise -o fixed_doc.pdf scanned_doc.pdf，轻松完成页面方向的批量修正。

3. 提取文本内容用于数据分析

场景：从数百份PDF格式的发票中提取所有文本，以便使用 grep 或其他工具搜索特定的订单号或金额。

这是命令行工具最具优势的领域之一。pdfly 可以将提取的文本直接输出到标准输出（stdout），方便地通过管道传递给其他命令。

pypdf 实现逻辑：

from pypdf import PdfReader

reader = PdfReader("invoice_123.pdf")
for page in reader.pages:
    print(page.extract_text())

使用 pdfly，你可以构建一个强大的处理链。例如，编写一个简单的 Shell 脚本，遍历所有发票文件，提取文本并搜索关键信息：

#!/bin/bash

for invoice in invoices/*.pdf; do
  echo "Processing $invoice..."
  # 使用 pdfly 提取文本，并通过管道交由 grep 搜索订单号
  if pdfly extract-text "$invoice" | grep -q "PO-2025-"; then
    echo "Found target order in $invoice"
    # 可在此添加移动文件、记录日志等更多操作
  fi
done

这个例子完美诠释了 pdfly 作为自动化“粘合剂”的角色。正如 pypdf 官方文档所指出的，pdfly 是一个“用于与 PDF 交互的 CLI 应用程序”，其价值在于将底层库的复杂性转化为终端用户易于使用的工具。

结论

在要求高效率和自动化的今天，依赖手动 GUI 操作来处理批量 PDF 任务已然过时。pdfly 作为 pypdf 库的官方命令行前端，为开发者和高级用户提供了一套功能丰富且易于集成的工具集。它不仅能处理常见的合并、拆分、旋转等任务，更核心的价值在于其出色的脚本化能力，可以无缝融入现有的自动化工作流中，无论是CI/CD流水线中的报告生成，还是数据处理管道中的文本提取。

如果你还在为繁琐的 PDF 操作而烦恼，不妨将 pdfly 加入你的工具箱。它将以命令行独有的简洁与高效，为你开启 PDF 处理自动化的新大门。