CMake find_package无法自动引入依赖库头文件目录的问题排查

我来帮你排查下这个问题，核心原因是你的libproj在打包配置时的头文件路径和实际安装路径不匹配，再加上头文件安装后的目录结构和你代码里的引用方式不契合，导致find_package没法自动把正确的包含目录传给binproj。咱们一步步来解决：

问题1：INSTALL_INTERFACE路径与实际头文件安装路径不匹配 #

在libproj/CMakeLists.txt的target_include_directories配置中，INSTALL_INTERFACE只指向了系统默认的include目录（/usr/local/include），但你实际把头文件安装到了/usr/local/include/libproj-proj-lib这个子目录里。CMake生成的导出目标不会自动识别这个子目录，所以binproj找不到头文件。

修正方法：
修改libproj的target_include_directories中INSTALL_INTERFACE的路径，加上你实际安装头文件的子目录：

target_include_directories(
    ${TARGET_NAME} PUBLIC
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/inc>
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/gen/src>
    # 修正这里的路径，匹配实际安装的子目录
    $<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}/${PROJECT_NAME}-${TARGET_ALIAS_NAME}>
)

问题2：头文件安装结构与代码引用方式不匹配 #

你在main.cpp里直接写#include "def.hpp"，但按照当前libproj的安装命令，def.hpp会被安装到/usr/local/include/libproj-proj-lib/gen/src/def.hpp，所以即使包含目录正确，你也得写#include "gen/src/def.hpp"才能找到。如果想保持#include "def.hpp"的引用方式，需要调整头文件的安装逻辑。

可选修正方法：
修改libproj中安装头文件的install命令，把inc和gen/src目录下的头文件直接复制到目标include子目录（而不是带着原目录结构）：

install(
    # 注意路径末尾加/，表示复制目录内的内容而非目录本身
    DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/inc/" "${CMAKE_CURRENT_SOURCE_DIR}/gen/src/"
    DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}/${PROJECT_NAME}-${TARGET_ALIAS_NAME}"
    FILES_MATCHING PATTERN "*.h" PATTERN "*.hpp"
)

这样修改后，def.hpp会直接出现在/usr/local/include/libproj-proj-lib/下，就能直接用#include "def.hpp"引用了。

额外小问题：binproj中的目标名称不统一 #

你的binproj/CMakeLists.txt里定义了TARGET_NAME proj_bin，但add_executable用的是${PROJECT_NAME}（也就是binproj），后面的target_link_libraries又用了${TARGET_NAME}，这会导致CMake报错找不到目标。建议统一目标名称：

add_executable(${TARGET_NAME} ${SRC})

target_link_libraries(
    ${TARGET_NAME} PRIVATE
    libproj::proj-lib
)

最后验证步骤 #

1. 重新编译并安装libproj：

cd libproj/build
cmake ..
make install

2. 清理binproj的构建目录，重新执行CMake和编译：

cd binproj/build
rm -rf *
cmake ..
make

这样调整后，find_package(libproj REQUIRED)就能自动把正确的头文件包含目录传给binproj，代码里的头文件引用也能正常工作了。

备注：内容来源于stack exchange，提问作者Harry