Windows系统Python环境安装PaddleOCR遇PyMuPDF编译错误求助

问题根源 #

1. PyMuPDF源码编译依赖Visual Studio的devenv.com工具，但系统未安装该工具或未配置环境变量，导致构建MuPDF失败。
2. 旧版vision包的.pth文件损坏，触发AttributeError: 'NoneType' object has no attribute 'loader'报错。

修复步骤 #

1. 清理损坏的vision包 #

执行卸载命令：

pip uninstall -y vision

若卸载失败，手动删除以下文件：

• C:\Users\Local\Programs\Python\Python311\Lib\site-packages\vision-1.0.0-py3.11-nspkg.pth
• Python site-packages目录下的vision文件夹

2. 安装预编译版PyMuPDF（推荐） #

跳过源码编译环节，直接安装官方预编译的wheel包，无需依赖Visual Studio环境：

pip install pymupdf --only-binary :all: -i https://pypi.tuna.tsinghua.edu.cn/simple

3. 重新安装PaddleOCR #

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

备选：源码编译PyMuPDF的前置要求 #

若必须从源码构建PyMuPDF，需完成以下配置：

• 安装Visual Studio 2019/2022，并勾选C++桌面开发组件
• 将devenv.com的路径（如C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\devenv.com）添加到系统PATH环境变量
• 重启终端后再执行安装命令

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