安装HDF5库后执行make test仍提示找不到hdf5.h，求助排查

你的猜测完全正确——这个错误几乎肯定是因为系统编译工具链找不到HDF5的头文件路径导致的，和~/.bashrc里未配置相关环境变量直接相关。下面是一步步的解决方法：

• 第一步：先定位HDF5头文件的实际位置
  先通过命令确认你的系统里hdf5.h到底在哪：

  find /usr -name hdf5.h
  

  因为你安装了三个不同版本的HDF5（serial/mpich/openmpi），对应的头文件路径会不一样，通常会在/usr/include/hdf5/serial/、/usr/include/hdf5/mpich/或/usr/include/hdf5/openmpi/其中一个目录下。

• 第二步：临时配置环境变量（单次会话生效）
  根据你实际要用的HDF5版本，设置对应的环境变量，比如你想用serial版本的话：

  # 设置头文件搜索路径
  export C_INCLUDE_PATH=/usr/include/hdf5/serial:$C_INCLUDE_PATH
  # 设置库文件搜索路径
  export LIBRARY_PATH=/usr/lib/x86_64-linux-gnu/hdf5/serial:$LIBRARY_PATH
  # 设置运行时库路径（可选，但避免后续运行程序时找不到库）
  export LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu/hdf5/serial:$LD_LIBRARY_PATH
  

  把路径里的serial换成mpich或openmpi就能切换到对应版本。设置完后再重新运行make test，应该就能找到头文件了。

• 第三步：永久配置到~/.bashrc（每次登录自动生效）
  如果不想每次打开终端都重新设置，就把上面的环境变量加到~/.bashrc里：

  1. 打开bashrc文件：nano ~/.bashrc
  2. 在文件末尾添加以下内容（记得替换成你找到的实际路径）：

     # 配置HDF5环境变量
     export C_INCLUDE_PATH=/usr/include/hdf5/serial:$C_INCLUDE_PATH
     export LIBRARY_PATH=/usr/lib/x86_64-linux-gnu/hdf5/serial:$LIBRARY_PATH
     export LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu/hdf5/serial:$LD_LIBRARY_PATH
     

  3. 保存退出后，执行source ~/.bashrc让改动立即生效。

• 替代方案：直接在编译命令中指定路径
  如果你不想修改环境变量，也可以在make命令里直接通过编译参数指定HDF5的路径：

  make test CFLAGS="-I/usr/include/hdf5/serial" LDFLAGS="-L/usr/lib/x86_64-linux-gnu/hdf5/serial -lhdf5"
  

  同样，根据你使用的HDF5版本替换路径即可。

关于你提到的Python相关功能测试，如果你用的是h5py这类常用库，正常安装时它会自动检测系统中的HDF5库；如果遇到检测失败的情况，可以尝试用源码编译安装：

pip install h5py --no-binary=h5py

这样安装过程会复用你设置的HDF5环境变量，确保链接到你已经安装的版本。

内容的提问来源于stack exchange，提问作者Fornax-A