在 Windows WSL 中安装 OCRmyPDF 并让 Windows 命令行可直接调用 ocrmypdf

发布时间:2026/9/10 18:47:08
在 Windows WSL 中安装 OCRmyPDF 并让 Windows 命令行可直接调用 ocrmypdf 在 Windows WSL 中安装 OCRmyPDF 并让 Windows 命令行可直接调用 ocrmypdf【免费下载链接】OCRmyPDFOCRmyPDF adds an OCR text layer to scanned PDF files, allowing them to be searched项目地址: https://gitcode.com/GitHub_Trending/oc/OCRmyPDF如果你的 Windows 机器上运行着 Windows Subsystem for LinuxWSL又不想在 Windows 侧分别安装 Python、Tesseract、Ghostscript 这一整套 64 位依赖那么可以直接在 WSL 的 Ubuntu 里安装 OCRmyPDF再通过一条符号链接命令让 Windows 的命令行提示符、PowerShell 乃至批处理文件都能用wsl ocrmypdf调用它。本文基于 OCRmyPDF 官方安装文档中 “Installing on Windows / Windows Subsystem for Linux” 一节的步骤覆盖从 WSL 内安装到 Windows 侧验证的完整路径。官方文档给出的前提只有两条WSL 中已安装 Ubuntu 22.04文档明确以 Ubuntu 22.04 for WSL 为前提如未安装需先安装未安装时可跳过第 1 步直接进入 Ubuntu 内的安装流程。需要说明的是OCRmyPDF 不支持任何 32 位系统包括 32 位 Python 或 32 位 GhostscriptWSL 场景下请使用 64 位 Ubuntu 发行版。在 WSL 的 Ubuntu 中安装 OCRmyPDF在 WSL 的 Ubuntu 终端里操作。官方 WSL 一节引用的就是 “Installing the latest version on Ubuntu 22.04/24.04 LTS” 流程先装系统依赖再用 uv 装最新版 Python 包。# Install system dependencies first sudo apt-get update sudo apt-get -y install ocrmypdf # Install uv and upgrade to the latest OCRmyPDF pip install uv uv pip install --user --upgrade ocrmypdf两步分工不同apt install ocrmypdf会带上 Tesseract、Ghostscript 等系统级依赖但 Ubuntu 仓库里的版本可能落后于上游最新版本所以文档建议紧接着用 uv 升级uv pip install --user --upgrade ocrmypdf从 PyPI 安装最新 release脚本落在~/.local/bin下。这里用--upgrade很关键如果没有它而 apt 已经装过只会提示已满足要求而不会真正升级。一个已知限制Debian/Ubuntu 的 OCRmyPDF 包目前不含 JBIG2 编码器JBIG2 专利已于 2017 年全部到期。没有它 OCRmyPDF 可以正常工作只是输出文件会更大如需要可参考文档 JBIG2 一节 自行构建 jbig2enc安装后 OCRmyPDF 会自动从PATH中检测到它。在 Windows 命令行创建符号链接并验证安装完成后从Windows 命令行提示符或 PowerShell注意不是在 WSL 里执行官方文档给出的这条命令wsl sudo ln -s /home/$USER/.local/bin/ocrmypdf /usr/local/bin/ocrmypdf命令中的$USER是 Windows 环境变量取值为 Windows 当前用户名也就是 WSL 里 Ubuntu 的/home下的用户目录这条命令会在 WSL 文件系统内创建符号链接把uv pip install --user安装到的~/.local/bin/ocrmypdf映射到/usr/local/bin/ocrmypdf使wsl ocrmypdf能够按绝对路径找到可执行文件它需要 sudo 权限用于写入 WSL 内的/usr/local/bin只影响 WSL 文件系统的这一个链接不改动 Windows 侧任何内容。然后验证版本确认安装的是 PyPI 上的预期版本wsl ocrmypdf --version版本输出符合预期后就可以在 Windows 命令行或 PowerShell 中用wsl前缀调用 OCRmyPDF 了例如wsl ocrmypdf in.pdf out.pdf官方文档同时说明这样也可以从 Windows 程序和批处理文件中调用它。已知限制与适用边界文档中 WSL 一节按 Ubuntu 22.04 给出符号链接指向~/.local/bin与上面 uv--user安装的位置一致若改用其他安装方式如 apt 单包或虚拟环境该链接路径可能不成立。同样的安装文档还提供了 Windows 原生安装winget/Chocolatey pip和 Cygwin64 两条路径它们与本文的 WSL 路径互不替代这里不再展开。32 位系统不受支持包括 32 位 Windows 下的 32 位 Python 和 32 位 Ghostscript。完整安装选项Docker 镜像、Homebrew、pip/pipx 等可继续参考 安装文档。【免费下载链接】OCRmyPDFOCRmyPDF adds an OCR text layer to scanned PDF files, allowing them to be searched项目地址: https://gitcode.com/GitHub_Trending/oc/OCRmyPDF创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

关于本文作者

来自尧图内容编辑团队

尧图内容编辑团队 内容团队

尧图内容编辑团队

本文由尧图网络内容编辑团队执笔。团队由资深项目经理、前端工程师与设计师组成,所有内容均来自亲手交付的真实项目,先讲清问题、再给出可落地的解法。尧图深耕北京网站建设十年,服务过京华建材集团、智造科技等各行业客户,把一线经验沉淀为可复用的行业观察。

  • 十年建站经验,覆盖建材、制造、服务、文创等
  • 项目经理把关选题与事实准确性
  • 工程师与设计师联合撰写专业细节
  • 统一编辑规范,保证文风与排版一致
  • 每月复盘转化数据,迭代选题方向

延伸阅读

相关资讯与近期热门内容

深度阅读推荐

建站决策前值得细读的三篇

网站改版的5个关键决策
2024-08-12

网站改版的5个关键决策

什么时候该改版、改到什么程度、如何避免流量掉光,京华建材集团改版复盘给出答案。

获取专属建站方案

看完文章,把您的行业与预算告诉我们,免费获取一份量身定制的官网建设方案与报价。

立即免费咨询