Python3.9.7安装BerkeleyDB18.1.8时出现PIP Wheel构建错误求助

错误根源 #

报错核心是FileNotFoundError: [Errno 2] No such file or directory: 'db/include\\db.h'，说明Python的berkeleydb包在源码编译时找不到BerkeleyDB的头文件——Windows系统默认没有预装BerkeleyDB的开发环境，pip从源码构建时必须依赖这些文件才能完成编译。

可行解决方案 #

1. 先安装BerkeleyDB开发库，再指定路径安装Python绑定 #

• 下载BerkeleyDB 18.1.8的Windows官方二进制包（选择和你的Python匹配的32/64位版本），解压到固定路径，比如C:\BerkeleyDB\18.1.8，确保解压后目录下有include（包含db.h）和lib文件夹。
• 打开命令提示符，设置环境变量指向BerkeleyDB路径：

  set BDB_PREFIX=C:\BerkeleyDB\18.1.8
  

• 执行pip安装命令：

  pip install berkeleydb==18.1.8
  

2. 使用预编译的Python berkeleydb轮子（避免源码编译） #

• 查找对应Python 3.9版本的berkeleydb预编译.whl文件（注意匹配系统位数）。
• 下载后通过本地文件安装：

  pip install D:\downloads\berkeleydb-18.1.8-cp39-none-win_amd64.whl
  

  （替换为你实际的轮子文件路径）

3. bsddb3的正确安装方式 #

• bsddb3同样依赖BerkeleyDB开发库，要么先按方案1安装BerkeleyDB，要么找到对应Python3.9的bsddb3预编译轮子进行本地安装，直接用pip源码安装同样会遇到头文件缺失问题。

4. Python版本调整建议 #

• 降级到3.6或升级Python版本并非必须优先选项，Python3.9完全支持BerkeleyDB 18.1.8，问题核心是缺失编译依赖，优先尝试上述方案。如果上述方案都无效，再考虑切换到有成熟预编译轮子支持的Python版本。

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