能否调试CMake的find_library？如何获取其搜索路径列表

当然可以调试find_library命令！下面我给你几个实用的方法，帮你获取它的搜索路径列表，同时排查你遇到的找不到/lib64/libfoo.so.0的问题。

一、启用CMake查找调试模式（最直观的方法） #

这是最直接的方式，能让CMake输出find_library的完整查找过程，包括遍历的每一条路径、检查的文件名，甚至会说明为什么某个文件被跳过。

• 方法1：使用--debug-find命令行选项（CMake 3.17+）
  运行CMake时加上这个选项就行：

  cmake .. --debug-find
  

  执行后，你会看到大量详细日志，其中就包含find_library搜索的所有路径，以及每个路径下尝试匹配的文件名。

• 方法2：设置CMAKE_FIND_DEBUG_MODE变量
  如果你用的是旧版CMake（低于3.17），可以通过设置这个变量开启调试：
  要么在命令行指定：

  cmake .. -DCMAKE_FIND_DEBUG_MODE=ON
  

  要么在CMakeLists.txt的开头添加：

  set(CMAKE_FIND_DEBUG_MODE ON)
  

  效果和--debug-find一致，能清晰看到find_library是否真的遍历了/lib64路径。

二、手动打印关键搜索路径变量 #

如果想精准查看find_library依赖的路径集合，可以在CMakeLists.txt中添加打印语句，输出几个核心变量：

# 打印系统默认的库搜索路径
message(STATUS "系统默认库路径：${CMAKE_SYSTEM_LIBRARY_PATH}")
# 打印用户自定义的库搜索路径
message(STATUS "用户自定义库路径：${CMAKE_LIBRARY_PATH}")
# 打印前缀路径（会间接影响库的搜索范围）
message(STATUS "前缀路径：${CMAKE_PREFIX_PATH}")
# 确认你设置的FIND_LIBRARY_USE_LIB64_PATHS是否真的生效
message(STATUS "FIND_LIBRARY_USE_LIB64_PATHS状态：${FIND_LIBRARY_USE_LIB64_PATHS}")

运行CMake后，这些变量的值会被输出，你可以检查/lib64是否在列表中。

三、针对你的场景的额外排查点 #

你提到已设置FIND_LIBRARY_USE_LIB64_PATHS=TRUE，但还是找不到/lib64/libfoo.so.0，可以再检查这几点：

• 库名匹配是否正确：在Linux下，find_library会自动给你指定的名字加上lib前缀，所以你写的NAMES foo foo.so.0，实际会查找libfoo.so和libfoo.so.0，这和你的库文件名完全匹配，这点应该没问题，但可以在调试日志中确认实际查找的文件名。
• 文件权限是否足够：CMake运行时的用户是否有读取/lib64/libfoo.so.0的权限？如果权限不足，find_library会跳过这个文件。
• CMake版本是否兼容：FIND_LIBRARY_USE_LIB64_PATHS是CMake 3.12才引入的变量，如果你的CMake版本低于3.12，这个变量不会生效。这种情况下，你可以手动把/lib64添加到搜索路径中：

  list(APPEND CMAKE_LIBRARY_PATH "/lib64")
  

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