在macOS系统中通过pip安装pyhdf库时，经常会遇到编译阶段报错，提示找不到hdf.h文件，这是由于pyhdf依赖HDF4库的开发文件，而系统默认没有预装相关依赖导致的。解决该问题需要先安装HDF4库，再配置正确的编译路径才能完成安装。
错误原因分析
pyhdf是Python对HDF4格式的封装库，安装时需要编译C扩展代码，而编译过程需要HDF4库的头文件（如hdf.h）和链接库。如果系统中没有安装HDF4开发包，或者编译器无法找到头文件的存放路径，就会出现hdf.h文件未找到的错误。
解决步骤
第一步：安装HDF4依赖库
推荐使用Homebrew包管理器安装HDF4，首先确保已经安装Homebrew，如果没有可以通过以下命令安装：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后，执行以下命令安装HDF4：
brew install hdf4
安装完成后，HDF4的头文件会存放在/opt/homebrew/include（Apple Silicon芯片）或者/usr/local/include（Intel芯片）目录下，hdf.h文件就在其中。
第二步：配置编译路径
安装pyhdf时需要指定HDF4的头文件和库文件路径，可以通过环境变量配置：
如果是Apple Silicon芯片的macOS，执行以下命令：
export CFLAGS="-I/opt/homebrew/include" export LDFLAGS="-L/opt/homebrew/lib"
如果是Intel芯片的macOS，执行以下命令：
export CFLAGS="-I/usr/local/include" export LDFLAGS="-L/usr/local/lib"
第三步：安装pyhdf
配置完环境变量后，直接使用pip安装即可：
pip install pyhdf
验证安装
安装完成后，可以进入Python交互环境验证是否安装成功：
import pyhdf
from pyhdf.SD import SD
print("pyhdf安装成功")
如果没有报错，说明安装已经完成。
常见问题处理
- 如果执行brew install hdf4时提示找不到包，可以先执行
brew update更新Homebrew的包索引后再尝试安装。 - 如果配置环境变量后仍然报错找不到hdf.h，可以检查对应路径下是否存在该文件，如果路径不一致需要调整CFLAGS中的路径为实际的hdf.h存放目录。
- 如果使用虚拟环境安装，需要在激活虚拟环境后再配置环境变量和执行安装命令，确保路径配置生效。