CMake Config模式下formfactor库find_package未找到库且不触发REQUIRED报错

核心问题定位 #

1. 自定义变量未导出 #

项目中Config.cmake.in仅配置了formfactor_INCLUDE_DIR变量，未定义下游代码用到的formfactor_LIBRARY变量。你在ff目录CMakeLists.txt中设置的set(${lib}_LIBRARY ${lib} PARENT_SCOPE)仅在项目自身构建上下文生效，不会传递到安装后的Config配置文件中，下游无法读取该值。

2. REQUIRED参数未触发错误的原因 #

CMake CONFIG模式下find_package的REQUIRED校验仅检查Config配置文件是否成功加载、版本是否兼容，只要配置文件加载成功就会标记formfactor_FOUND=1，不会校验自定义的业务变量是否存在，因此不会触发致命错误。

符合CMake规范的解决方案 #

方案1：优先推荐（现代CMake标准用法） #

修改下游代码直接使用CMake自动导出的导入目标，无需依赖自定义变量：

find_package(formfactor REQUIRED CONFIG)
# 直接链接导入目标，CMake会自动处理头文件路径、库路径、编译参数等所有关联配置
target_link_libraries(你的下游业务目标 PRIVATE formfactor::formfactor)

如果需要打印调试信息，可直接读取导入目标的属性：

get_target_property(formfactor_INCLUDE_DIR formfactor::formfactor INTERFACE_INCLUDE_DIRECTORIES)
get_target_property(formfactor_LIBRARY formfactor::formfactor LOCATION)
message(STATUS "formfactor: found=${formfactor_FOUND}, include_dirs=${formfactor_INCLUDE_DIR}, lib=${formfactor_LIBRARY}, version=${formfactor_VERSION}")

方案2：兼容下游旧代码写法 #

如果无法修改下游代码，可修改Config.cmake.in补充变量定义：

set(formfactor_INCLUDE_DIR @CMAKE_INSTALL_PREFIX@/include)
include(${CMAKE_CURRENT_LIST_DIR}/formfactorTargets.cmake)
# 补充定义下游需要的库变量，指向自动导出的导入目标
set(formfactor_LIBRARY formfactor::formfactor)

其他可能的问题排查点 #

• 检查库文件是否正常安装：默认安装路径下的lib目录是否存在对应系统格式的formfactor库文件。
• 检查formfactorTargets.cmake是否被正确安装到了配置指定的cmake目录下，路径与Config文件中引用的路径是否一致。
• 如果是直接使用构建目录下export导出的Targets文件（未执行install操作），检查CMAKE_INSTALL_PREFIX配置是否和实际使用的路径匹配。
  内容的提问来源于stack exchange，提问作者Joachim W