pip安装pikepdf v6.0.0缺失qpdf/Constants.h头文件报错如何解决？

故障原因 #

pikepdf 从 v5.x 版本开始调整了发布规则，Windows 平台下部分高版本不再提供开箱即用的预编译 wheel 包，源码编译时依赖原生 qpdf 库的开发头文件，你遇到的 qpdf/Constants.h 缺失报错就是本地未提前安装 qpdf 开发包导致的。

可自行操作的解决方法 #

• 方案1：指定安装兼容版本
  你之前使用的 v4.0.1.post1 版本有适配 Windows 的预编译包，无需编译可直接安装，执行命令即可：
  pip install pikepdf==4.0.1.post1
  如果需要使用更高版本的功能，也可选择 v5.x 系列的最后稳定版，同样有预编译包支持。
• 方案2：使用 conda 安装
  conda 源的 pikepdf 所有版本都已打包好了对应的 qpdf 依赖，无需自行编译，执行命令即可：
  conda install -c conda-forge pikepdf
• 方案3：提前安装 qpdf 开发包后编译安装（如需强制使用 v6.0.0 版本）

1. 下载 Windows 平台的 qpdf 开发包，解压到本地目录
2. 分别将解压后目录下的 include 文件夹路径添加到系统 INCLUDE 环境变量，lib 文件夹路径添加到系统 LIB 环境变量，bin 文件夹路径添加到系统 PATH 环境变量
3. 重启命令行工具后重新执行安装命令：
   pip install pikepdf==6.0.0

补充说明 #

如果 pip 版本过低，也可能出现无法匹配对应预编译包、强制走源码编译的情况，可先升级 pip 后重试安装：
python -m pip install --upgrade pip

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