Python3.8.16环境下安装PaddleOCR时PyMuPDF安装失败求助

问题重现 #

安装PaddleOCR过程中，PyMuPDF安装失败，报错信息如下：

error: command 'swig' failed with exit status 1
[输出结束]
注意：此错误来自子进程，大概率不是pip的问题。
正在回滚PyMuPDF的卸载操作
移动文件：
/Users/derekbai/.pyenv/versions/3.8.16/lib/python3.8/site-packages/PyMuPDF-1.21.1.dist-info/
从
/Users/derekbai/.pyenv/versions/3.8.16/lib/python3.8/site-packages/~yMuPDF-1.21.1.dist-info
移动文件：
/Users/derekbai/.pyenv/versions/3.8.16/lib/python3.8/site-packages/fitz/
从
/Users/derekbai/.pyenv/versions/3.8.16/lib/python3.8/site-packages/~itz
错误：legacy-install-failure

× 安装包时遇到错误。
╰─> PyMuPDF

解决方案 #

1. 安装swig依赖 #

报错核心是系统缺少swig工具，PyMuPDF编译时依赖该工具，根据操作系统执行对应安装命令：

• macOS（Homebrew）：

  brew install swig
  

• Ubuntu/Debian：

  sudo apt-get update && sudo apt-get install swig
  

• CentOS/RHEL：

  sudo yum install swig
  

2. 重新安装PyMuPDF #

swig安装完成后，重新执行安装命令：

pip install PyMuPDF==1.21.1

或直接重新安装PaddleOCR：

pip install paddleocr

3. 尝试预编译版本（跳过编译） #

若仍出现编译失败，可直接安装预编译的wheel包，避免本地编译步骤：

pip install PyMuPDF --only-binary :all:

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