如何在PopOS上安装netCDF C++并解决头文件查找问题

1. 问题根源 #

PopOS基于Ubuntu，属于Debian系发行版，这类系统会将HDF5的头文件默认放在/usr/include/hdf5/serial路径下，但CMake自带的FindHDF5模块不会自动搜索这个非标准路径，因此编译netcdf-cxx4时会出现找不到<hdf5.h>的报错。

另外，你找不到<netcdfcpp.h>是因为系统默认安装的netCDF包仅包含C语言组件，C++绑定需要单独编译安装（也就是你下载的netcdf-cxx4源码）。

2. 无需修改代码的CMake自动识别方案 #

以下方法均无需改动netcdf-cxx4源码，仅通过环境变量或CMake参数实现自动路径识别：

方法一：利用pkg-config引导CMake #

PopOS的HDF5安装包会提供pkg-config配置文件，先确认文件存在：

pkg-config --exists hdf5 && echo "HDF5 pkg-config文件已找到"

若存在，先设置环境变量让CMake优先读取pkg-config的配置：

export CMAKE_PREFIX_PATH="/usr/lib/x86_64-linux-gnu/hdf5/serial:$CMAKE_PREFIX_PATH"
export PKG_CONFIG_PATH="/usr/lib/x86_64-linux-gnu/hdf5/serial/pkgconfig:$PKG_CONFIG_PATH"

之后正常执行netcdf-cxx4的编译流程：

mkdir build && cd build
cmake ..
make
sudo make install

方法二：直接给CMake传递HDF5根路径参数 #

如果pkg-config方法无效，可在CMake命令中直接指定HDF5的根目录，CMake会自动搜索其子路径下的头文件和库：

mkdir build && cd build
cmake -DHDF5_ROOT=/usr/lib/x86_64-linux-gnu/hdf5/serial ..
make
sudo make install

方法三：全局配置CMake的HDF5搜索路径 #

若不想每次编译都手动设置参数，可创建CMake全局配置文件，永久添加HDF5的路径：

sudo mkdir -p /etc/cmake/Modules
# 替换下面的cmake-3.x为你系统实际的CMake版本（用cmake --version查看）
sudo tee /etc/cmake/Modules/FindHDF5.cmake <<EOF
include(/usr/share/cmake-3.x/Modules/FindHDF5.cmake)
list(APPEND HDF5_INCLUDE_DIRS "/usr/include/hdf5/serial")
list(APPEND HDF5_LIBRARY_DIRS "/usr/lib/x86_64-linux-gnu/hdf5/serial")
EOF

配置完成后，后续编译netcdf-cxx4或其他依赖HDF5的项目时，CMake会自动识别该路径。

3. 后续编译自己的C++代码注意事项 #

netcdf-cxx4安装完成后，<netcdfcpp.h>会默认放在/usr/local/include目录下，编译自己的代码时，确保CMake或编译器能搜索到该路径即可（通常系统会自动识别/usr/local/include，若未识别可在CMakeLists.txt中添加include_directories(/usr/local/include)）。

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