CMake Config模式find_package无法找到本地库配置文件的疑问

你对prefix搜索逻辑的误解 #

你以为指定${argsPath}作为prefix后，CMake会自动去prefix/lib/cmake/args找配置文件，但实际CMake不会遍历所有子目录，只会在预定义的标准子路径列表里搜索。你的配置文件所在路径确实在标准列表中，但找不到通常有两个关键原因：

原因1：64位系统默认优先搜索lib64 #

多数Linux 64位系统下，CMake会优先查找prefix/lib64/cmake/args，而非你库所在的lib目录。如果你的系统属于这种情况，即使指定了prefix，CMake也会先去lib64目录尝试，找不到才会看lib——但你的库只安装在lib里，自然搜不到。

原因2：旧版CMake的路径优先级问题 #

部分老版本CMake中，lib/cmake/<包名>的搜索优先级较低，可能被其他默认路径覆盖，导致明明路径存在却无法被找到。

为什么设置args_DIR可以生效 #

args_DIR是CMake专门为args包提供的路径变量，它直接指定配置文件所在的目录，跳过了prefix下的子路径搜索逻辑。当你把它设为${argsPath}/lib/cmake/args时，CMake会直接去该目录查找args-config.cmake，因此能成功找到。

无需手动指定args_DIR的解决方案 #

方案1：强制CMake优先搜索lib目录 #

在find_package之前添加以下配置，让CMake优先检查lib目录：

set(CMAKE_LIBRARY_ARCHITECTURE "")
set(CMAKE_FIND_LIBRARY_PREFIXES "")

或者更精准地将lib目录加入搜索路径：

set(CMAKE_LIBRARY_PATH "${argsPath}/lib" ${CMAKE_LIBRARY_PATH})

方案2：将配置文件目录直接加入CMAKE_PREFIX_PATH #

不用添加prefix，直接把配置文件所在的父目录加到CMAKE_PREFIX_PATH中：

set(CMAKE_PREFIX_PATH "${argsPath}/lib/cmake/args" ${CMAKE_PREFIX_PATH})
find_package(args REQUIRED CONFIG)

方案3：调整库的安装结构（如果有权限修改） #

把lib/cmake/args目录移动到prefix/cmake/args，这是CMake优先级更高的标准搜索路径，之后无需额外设置变量，find_package就能直接找到配置文件。

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