MacOS Big Sur安装PyMuPDF提示fitz.h文件不存在如何解决

该报错本质是pip编译PyMuPDF时，未识别到Homebrew安装的mupdf头文件路径，Apple Silicon架构Mac的Homebrew默认路径为/opt/homebrew，不在系统默认的编译搜索路径内，才会出现fitz.h找不到的问题。

• 第一步：清除已安装的残留版本，避免版本冲突

brew uninstall --force mupdf mupdf-tools
pip3 uninstall -y PyMuPDF

• 第二步：安装版本匹配的mupdf依赖

brew install mupdf@1.21

• 第三步：临时导入编译路径后安装对应版本PyMuPDF

export C_INCLUDE_PATH=/opt/homebrew/include/mupdf:/opt/homebrew/opt/mupdf@1.21/include
export LIBRARY_PATH=/opt/homebrew/lib:/opt/homebrew/opt/mupdf@1.21/lib
pip3 install PyMuPDF==1.21.1

• 备用方案：跳过本地编译，直接安装预构建的二进制版本，无需处理依赖适配

pip3 install --only-binary :all: PyMuPDF

如果是Intel架构的Mac，将上述路径中的/opt/homebrew替换为/usr/local即可生效。

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