Python3.7环境安装Calliope包失败求助：HDF5 headers未找到

错误根源 #

安装Calliope时，其依赖的netCDF4包需要编译，而系统中缺少HDF5开发头文件，导致编译失败，核心报错为：

ValueError: did not find HDF5 headers

解决方案 #

方案1：用Anaconda安装（最省心，推荐） #

Anaconda会自动处理所有编译依赖，无需手动配置HDF5：

1. 先安装兼容版本的netCDF4：

   conda install -c conda-forge netcdf4
   

2. 再安装Calliope：

   conda install -c conda-forge calliope=0.6.8
   

或者直接一步完成：

conda install -c conda-forge calliope=0.6.8

方案2：用pip安装（Windows 32位环境） #

绕过编译环节，直接使用预编译的netCDF4包：

1. 找到适配Python3.7 32位的netCDF4预编译.whl文件（对应版本1.6.2）
2. 先安装本地wheel文件：

   pip install 你的文件路径\netCDF4-1.6.2-cp37-cp37m-win32.whl
   

3. 再安装Calliope：

   pip install calliope==0.6.8
   

方案3：手动安装HDF5开发库 #

1. 下载适配Windows 32位的HDF5官方安装包并完成安装
2. 设置系统环境变量HDF5_DIR，值为HDF5的安装路径（例如C:\Program Files (x86)\HDF_Group\HDF5\1.12.2）
3. 重启PyCharm或命令行，重新执行pip install calliope==0.6.8

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