如何配置CMake子目录项目使find_package跨子项目找到依赖库？

核心思路 #

CMake的find_package默认优先查找系统已安装的库，而非当前构建树内的子项目。要让子项目的find_package识别到上层通过add_subdirectory添加的依赖，核心是提前设置关键变量，强制子项目的find_package直接使用本地构建的目标，跳过系统搜索流程。

具体操作步骤 #

1. 按依赖层级顺序添加子项目 #

在顶层CMakeLists.txt中，严格按照依赖从低到高的顺序添加子项目：

# 先添加最底层的HDF5
add_subdirectory(deps/hdf5)
# 再添加依赖HDF5的netCDF C
add_subdirectory(deps/netcdf-c)
# 最后添加依赖netCDF C的netCDF C++
add_subdirectory(deps/netcdf-cxx4)

2. 为netCDF C设置HDF5识别变量 #

在添加netcdf-c的add_subdirectory之前，设置HDF5相关的缓存变量，让netCDF C的find_package(HDF5)直接指向本地构建版本：

# 标记HDF5已找到
set(HDF5_FOUND ON CACHE BOOL "" FORCE)
# 指定HDF5的头文件路径（源码目录+构建目录）
set(HDF5_INCLUDE_DIRS "${CMAKE_CURRENT_SOURCE_DIR}/deps/hdf5/src" "${CMAKE_CURRENT_BINARY_DIR}/deps/hdf5" CACHE PATH "" FORCE)
# 指定HDF5的库目标（直接引用构建树内的目标）
set(HDF5_LIBRARIES hdf5::hdf5 hdf5::hdf5_hl CACHE STRING "" FORCE)
# 若HDF5包含szip等额外组件，按需补充对应的库目标

3. 为netCDF C++设置netCDF C识别变量 #

同理，在添加netcdf-cxx4的add_subdirectory之前，设置netCDF C的相关缓存变量：

# 标记netCDF已找到
set(NETCDF_FOUND ON CACHE BOOL "" FORCE)
# 指定netCDF C的头文件路径
set(NETCDF_INCLUDE_DIRS "${CMAKE_CURRENT_SOURCE_DIR}/deps/netcdf-c/include" "${CMAKE_CURRENT_BINARY_DIR}/deps/netcdf-c" CACHE PATH "" FORCE)
# 指定netCDF C的库目标
set(NETCDF_LIBRARIES netcdf CACHE STRING "" FORCE)
# 若netCDF C包含额外组件，按需补充

4. 可选：通过前缀路径强化本地包搜索 #

如果上述变量设置仍不生效，可将子项目的构建目录加入CMAKE_PREFIX_PATH，让find_package优先读取本地生成的包配置文件（如<PackageName>Config.cmake）：

# 将HDF5构建目录加入前缀搜索路径
list(APPEND CMAKE_PREFIX_PATH "${CMAKE_CURRENT_BINARY_DIR}/deps/hdf5")
add_subdirectory(deps/netcdf-c)

# 将netCDF C构建目录加入前缀搜索路径
list(APPEND CMAKE_PREFIX_PATH "${CMAKE_CURRENT_BINARY_DIR}/deps/netcdf-c")
add_subdirectory(deps/netcdf-cxx4)

关键注意点 #

• 所有变量设置必须放在对应子项目的add_subdirectory之前，确保子项目执行find_package时能读取到这些强制配置。
• 使用CACHE ... FORCE是为了覆盖子项目内部可能定义的同名变量，保证上层配置的优先级。
• 全程无需修改依赖库的代码，也不需要执行install操作，完全通过顶层CMake控制依赖查找逻辑。

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