安装paddleocr时PyMuPDF编译wheel失败，请求技术支持

问题概述 #

尝试安装PaddleOCR时，PyMuPDF编译失败，核心错误为：

subprocess.CalledProcessError: Command 'cd mupdf-1.21.1-source/&&"C:/Program Files (x86)/Microsoft Visual Studio/2019\Community\Common7\IDE\devenv.com" platform/win32/mupdf.sln /Build "ReleaseTesseract|x64" /Project mupdf' returned non-zero exit status 1.

该错误源于VS2019编译MuPDF源码时失败，进而无法生成PyMuPDF的wheel包，最终阻断PaddleOCR的安装。

可行解决方案 #

• 优先使用预编译PyMuPDF包
  跳过本地编译环节，直接安装适配Windows的预编译wheel：

  pip install PyMuPDF -i https://pypi.tuna.tsinghua.edu.cn/simple
  

  安装完成后再执行pip install paddleocr即可。

• 补全VS2019编译组件
  打开Visual Studio Installer，修改现有安装，勾选**「使用C++的桌面开发」**组件，确保包含：

  • MSVC v142生成工具（对应VS2019版本）
  • Windows 10/11 SDK（匹配当前系统版本）
  • C++ CMake工具
    安装完成后重启命令行，重新尝试安装操作。

• 降级Python版本
  Python 3.12属于较新版本，旧版PyMuPDF（如错误中的1.21.1）未适配其编译环境。可切换至Python 3.11，创建新虚拟环境后重新执行安装命令。

• 安装适配性更好的PyMuPDF版本
  尝试安装更新版本的PyMuPDF，该版本已修复部分编译兼容问题：

  pip install PyMuPDF==1.23.0
  pip install paddleocr
  

内容的提问来源于stack exchange，提问作者Ahmedou Ahmed