Windows+Python3.11环境GitHub Actions安装PyMuPDF失败致PaddleOCR受阻

问题根因 #

devenv.com是Visual Studio的命令行编译工具，PyMuPDF在Windows环境构建wheel时需要依赖它。GitHub Actions的Windows运行环境默认未配置完整的VS编译环境，再加上Python3.11对应的PyMuPDF预编译wheel可能未及时更新，触发了源码编译流程，最终因找不到devenv.com导致构建失败，卡住了PaddleOCR的安装。

可行解决方案 #

1. 补装VS编译工具 #

在你的GitHub Actions Windows任务中添加步骤，安装VS构建工具，让系统能识别devenv.com：

- name: 安装VS构建工具
  uses: microsoft/setup-msbuild@v1.1
  with:
    vs-version: '17.0' # 适配Python3.11，版本可按需调整

或者用choco快速安装必要组件：

- name: 安装编译依赖
  run: choco install visualstudio2022-buildtools --package-parameters "--add Microsoft.VisualStudio.Workload.VCTools --includeRecommended"

2. 强制使用预编译wheel #

PyPI仓库已有针对Windows Python3.11的PyMuPDF预编译包，直接指定仅安装wheel包，跳过源码编译：

pip install pymupdf --only-binary :all:

如果PaddleOCR依赖特定版本的PyMuPDF，可指定版本号：

pip install pymupdf==x.x.x --only-binary :all:

3. 升级PyMuPDF到最新版 #

较新的PyMuPDF版本已修复Python3.11+Windows环境下的构建问题，直接升级到最新版尝试：

pip install --upgrade pymupdf

操作建议 #

将上述步骤添加到GitHub Actions工作流中，放在安装PaddleOCR的命令之前，确保PyMuPDF安装成功后再执行PaddleOCR的安装流程。

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