CMake find_package报错导入目标含不存在路径 如何查看搜索路径

报错的核心原因是你安装导出的CMake包配置中，导入目标绑定的头文件路径计算错误：

1. 你当前把sortdemo-config.cmake直接放在了安装前缀C:\ProgramFiles\的根目录，CMake自动计算的包根路径_IMPORT_PREFIX会向上多跳一级，最终指向C盘根目录，拼接出来的头文件路径是C:\include\sort，和你实际存放头文件的C:\ProgramFiles\include\sort完全不符。
2. 大概率你在编写库的CMake规则时，给目标设置头文件包含目录没有区分构建接口和安装接口，直接写了相对路径，CMake在下游项目解析导入目标时，会把相对路径识别为下游项目自身的相对路径，自然找不到对应文件。

• 直接查看安装生成的配置文件：打开你安装目录下的sortdemo-config.cmake以及同目录下的target配置文件（一般命名为*-targets-release.cmake格式），搜索my_sort_lib对应的INTERFACE_INCLUDE_DIRECTORIES属性，就能直接看到当前配置的错误头文件路径是什么。
• 加trace参数打印完整执行流程：在下游项目执行CMake配置时加上--trace-expand参数，会把所有CMake脚本执行过程、变量展开结果全量打印，直接搜索报错的目标名或者路径关键词，就能定位到错误路径是在哪一行脚本里赋值的，示例命令：

cmake -S . -B build --trace-expand > cmake_run.log 2>&1

• 打印目标属性直接验证：在下游项目的CMakeLists.txt里，find_package调用完成后加两行代码，直接打印导入目标的头文件路径，不需要翻日志就能看到路径错误：

find_package(sortdemo REQUIRED)
get_target_property(sort_lib_include my_sort_lib INTERFACE_INCLUDE_DIRECTORIES)
message(STATUS "my_sort_lib实际加载的头文件路径：${sort_lib_include}")

• 检查包查找路径：打开下游项目构建目录下的CMakeCache.txt，搜索sortdemo_DIR，可以确认CMake实际找到的config文件路径是不是你预期的安装目录，避免加载到其他位置的旧版本配置文件。

1. 调整头文件包含目录的写法，严格区分构建期和安装期的路径：给库目标设置target_include_directories时，必须用生成器表达式拆分两种场景的路径，不要直接写裸相对路径：

target_include_directories(my_sort_lib
    PUBLIC
    # 本地构建库时，用源码目录下的头文件路径
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}>
    # 安装后给下游用的路径，是相对于安装前缀的相对路径
    $<INSTALL_INTERFACE:include>
)

注意这里的INSTALL_INTERFACE值要和你代码里的#include写法匹配：如果代码里写#include "sort/sort.hpp"就填include，如果写#include "sort.hpp"就填include/sort。
2. 调整配置文件安装路径，遵循CMake标准包布局：不要把config文件直接丢在安装前缀根目录，统一安装到${CMAKE_INSTALL_PREFIX}/lib/cmake/sortdemo/目录下，这个路径是CMake官方约定的包配置存放路径，能保证自动计算的_IMPORT_PREFIX准确指向你的安装前缀根目录。同时Windows下动态库的dll文件建议安装到bin目录，避免运行时找不到dll。标准的安装导出写法参考：

install(TARGETS my_sort_lib my_print_lib
    EXPORT sortdemoTargets
    RUNTIME DESTINATION bin
    LIBRARY DESTINATION lib
    ARCHIVE DESTINATION lib
    INCLUDES DESTINATION include
)

install(EXPORT sortdemoTargets
    FILE sortdemo-targets.cmake
    NAMESPACE sortdemo::
    DESTINATION lib/cmake/sortdemo
)

install(FILES sortdemo-config.cmake
    DESTINATION lib/cmake/sortdemo
)

3. 重新执行构建安装命令后，再查看安装目录下生成的targets配置文件，确认INTERFACE_INCLUDE_DIRECTORIES属性值为${_IMPORT_PREFIX}/include这类正确的拼接路径，下游项目再调用find_package就不会报路径不存在的错误。

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