用途:OCRmyPDF 为扫描版 PDF 添加 OCR 文本层,使其可搜索、可复制粘贴,也可将图片转换为可搜索 PDF。它使用 Tesseract OCR,支持 100 多种语言,默认生成 PDF/A,并可将任务分配到所有 CPU 核心。
主要能力:支持基本 OCR、指定语言(如 -l fra、-l eng+fra、-l chi_sim+eng)、多种 OCR 模式(默认跳过已有文本、--force-ocr 强制、--redo-ocr 重做、--skip-text 跳过、--ocr-engine none 仅图像处理)、页面选择(--pages 1,3,5-10)、输出类型(pdfa、pdf、auto、none)、生成 sidecar 文本文件、设置元数据、并行处理(--jobs)。
安装:Debian/Ubuntu 用 apt install ocrmypdf;Fedora 用 dnf install ocrmypdf tesseract-osd;macOS 用 brew install ocrmypdf 或 port install ocrmypdf;FreeBSD 用 pkg install py-ocrmypdf;Snap 用 snap install ocrmypdf;pip 安装需先装系统依赖(Tesseract、Ghostscript)再 pip install ocrmypdf。验证用 ocrmypdf --version 和 ocrmypdf --help。
依赖:Python 3.11+、Tesseract 4.1.1+、Ghostscript 9.54+ 或 pypdfium2;可选 jbig2enc、pngquant、unpaper。
用法示例:ocrmypdf input.pdf output.pdf;ocrmypdf --image-dpi 300 scan.png output.pdf;ocrmypdf myfile.pdf myfile.pdf(原地处理,仅成功时覆盖);ocrmypdf --sidecar output.txt input.pdf output.pdf。
限制与注意:语言标识使用 ISO 639-3 代码;签名 PDF 需用 --invalidate-digital-signatures 覆盖,签名将失效;OCR 质量差时可检查语言包、尝试 --deskew 或 --oversample 300;输出文件过大可参考优化选项。图像处理、优化、批处理、Python API 等细节见对应技能文档。