Mac系统如何设置HDF5_DIR指向hdf5安装目录以解决GEOSX CMake报错

首先你的报错信息如下：

CMake Error at cmake/thirdparty/SetupGeosxThirdParty.cmake:131 (message):
GEOSX requires hdf5, set HDF5_DIR to the hdf5 installation directory.

按照以下步骤操作即可解决：

步骤1：安装HDF5并获取安装路径 #

• 推荐使用Homebrew安装HDF5，执行命令：
  brew install hdf5
• 安装完成后执行以下命令获取HDF5的安装根路径：
  brew --prefix hdf5
  Intel芯片Mac通常返回路径为/usr/local/opt/hdf5，M系列ARM芯片Mac通常返回路径为/opt/homebrew/opt/hdf5，如果你是手动编译安装的HDF5，直接使用你自己指定的安装根目录即可。

步骤2：配置HDF5_DIR参数 #

方式1：CMake执行时传参（推荐） #

直接在你的原有CMake命令末尾附加-DHDF5_DIR参数即可，示例：

# 自动获取路径写法
cmake .. -DHDF5_DIR=$(brew --prefix hdf5)

# 手动填写路径示例（M系列芯片）
cmake .. -DHDF5_DIR=/opt/homebrew/opt/hdf5

该方式不会修改全局环境，仅对当前次CMake配置生效。

方式2：临时环境变量配置 #

在执行CMake命令前，先在当前终端窗口执行以下命令设置临时环境变量：
export HDF5_DIR=$(brew --prefix hdf5)
配置完成后直接执行原有CMake命令即可，该配置仅对当前终端会话生效，关闭窗口后自动失效。

方式3：永久环境变量配置（可选） #

如果需要长期生效，可将配置写入Shell配置文件：

• 如果你使用zsh（Mac默认Shell），执行open ~/.zshrc打开配置文件
• 在文件末尾添加一行：export HDF5_DIR=$(brew --prefix hdf5)
• 保存退出后执行source ~/.zshrc让配置立即生效

配置完成后重新执行CMake命令即可。

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