Windows环境安装netCDF4==1.4.2报错：未找到HDF5头文件

问题背景 #

• 系统：Windows 10企业版64位
• Python版本：3.10.9
• 环境：Anaconda组件版本详情：

python                        3.10.9
anaconda-client               1.11.2
anaconda-navigator            2.4.0
anaconda-project              0.11.1
conda                         23.3.1
conda-build                   3.24.0
conda-content-trust           0.1.3
conda-pack                    0.6.0
conda-package-handling        2.0.2
conda_package_streaming       0.7.0
conda-repo-cli                1.0.41
conda-token                   0.4.0
conda-verify                  3.4.2
ipykernel                     6.19.2
ipython                       8.10.0
ipython-genutils              0.2.0
ipywidgets                    7.6.5
jupyter                       1.0.0
jupyter_client                7.3.4
jupyter-console               6.6.2
jupyter_core                  5.2.0
jupyter-server                1.23.4
jupyterlab                    3.5.3
jupyterlab-pygments           0.1.2
jupyterlab_server             2.19.0
jupyterlab-widgets            1.0.0
pip                           23.2

• 操作：执行pip install netCDF4==1.4.2安装包，Anaconda Prompt和PyCharm中均失败
• 报错信息：

(base) C:\Users\79>pip install netCDF4==1.4.2

Collecting netCDF4==1.4.2
Using cached netCDF4-1.4.2.tar.gz (769 kB)
Preparing metadata (setup.py) ... error
error: subprocess-exited-with-error

× python setup.py egg_info did not run successfully.
│ exit code: 1
╰─> [19 lines of output]
C:\Users\79\AppData\Local\Temp\pip-install-2bd1mj_1\netcdf4_e3f1e4ce8f52415499486dd692dea5ae\setup.py:170: DeprecationWarning: The SafeConfigParser class has been renamed to ConfigParser in Python 3.2. This alias will be removed in Python 3.12. Use ConfigParser directly instead.
config = configparser.SafeConfigParser()
Traceback (most recent call last):
File "<string>", line 2, in <module>
File "<pip-setuptools-caller>", line 34, in <module>
File "C:\Users\79\AppData\Local\Temp\pip-install-2bd1mj_1\netcdf4_e3f1e4ce8f52415499486dd692dea5ae\setup.py", line 371, in <module>
_populate_hdf5_info(dirstosearch, inc_dirs, libs, lib_dirs)
File "C:\Users\79\AppData\Local\Temp\pip-install-2bd1mj_1\netcdf4_e3f1e4ce8f52415499486dd692dea5ae\setup.py", line 319, in _populate_hdf5_info
raise ValueError('did not find HDF5 headers')
ValueError: did not find HDF5 headers
reading from setup.cfg...

          HDF5_DIR environment variable not set, checking some standard locations ..
      checking C:\Users\79 ...
      checking /usr/local ...
      checking /sw ...
      checking /opt ...
      checking /opt/local ...
      checking /usr ...
      [end of output]

note: This error originates from a subprocess, and is likely not a problem with pip.
error: metadata-generation-failed

× Encountered error while generating package metadata.
╰─> See above for output.

note: This is an issue with the package mentioned above, not pip.
hint: See above for details.

解决方案 #

方法1：用conda安装（推荐） #

Anaconda的conda包管理器会自动处理所有依赖（包括HDF5库和头文件），无需手动配置。在Anaconda Prompt中执行：

conda install netCDF4=1.4.2

如果指定版本无法找到，尝试从conda-forge频道安装：

conda install -c conda-forge netCDF4=1.4.2

方法2：手动配置HDF5路径后用pip安装 #

如果必须使用pip安装，需先确保HDF5已安装并指定路径：

1. 先通过conda安装HDF5：

conda install hdf5

2. 找到HDF5的安装目录，通常位于Anaconda base环境的Library文件夹下，示例路径：C:\Users\79\anaconda3\Library
3. 设置环境变量后执行pip安装：

set HDF5_DIR=C:\Users\79\anaconda3\Library
pip install netCDF4==1.4.2

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