CMake 中配置 find_package 的搜索路径

 

在 CMake 中配置 find_package 的搜索路径，可以通过以下方法实现：

---

​1. 设置 CMAKE_PREFIX_PATH

指定一个或多个根目录，CMake 会在此路径下按约定结构搜索库的配置文件（XXXConfig.cmake 或 FindXXX.cmake）。

cmake

复制

set(CMAKE_PREFIX_PATH "/path/to/custom/libs;/another/path")
find_package(SomeLib REQUIRED)

---

​2. 直接指定 PATHS 参数

在 find_package 命令中通过 PATHS 显式添加搜索路径。

cmake

复制

find_package(SomeLib REQUIRED
    PATHS "/path/to/somelib" 
          "/another/path"
    PATH_SUFFIXES lib/cmake/SomeLib  # 可选：添加子目录后缀
)

---

​3. 设置包特定的 XXX_DIR

直接指向包含 XXXConfig.cmake 的目录：

cmake

复制

set(SomeLib_DIR "/path/to/somelib/lib/cmake/SomeLib")
find_package(SomeLib REQUIRED)

---

​4. 使用环境变量

在终端中设置环境变量（或在 CMake 命令中传递）：

bash

复制

# 命令行设置
export SomeLib_DIR="/path/to/somelib/lib/cmake/SomeLib"
cmake ..

或通过 CMake：

cmake

复制

set(ENV{SomeLib_DIR} "/path/to/somelib/lib/cmake/SomeLib")

---

​5. 设置 CMAKE_MODULE_PATH

添加自定义 FindXXX.cmake 模块的路径：

cmake

复制

list(APPEND CMAKE_MODULE_PATH "/path/to/custom/find/modules")
find_package(SomeLib REQUIRED)

---

​6. 高级选项

• ​**NO_DEFAULT_PATH**：禁用默认搜索路径。
• ​**NO_CMAKE_PATH**：忽略 CMake 内置路径。
• ​**HINTS**：优先级高于 PATHS。

cmake

复制

find_package(SomeLib
    HINTS "/hint/path"
    PATHS "/explicit/path"
    NO_DEFAULT_PATH
)

---

​验证路径结构

确保路径符合 CMake 的搜索约定：

/path/to/lib/
├── include/
└── lib/cmake/SomeLib/SomeLibConfig.cmake

---

​调试搜索过程

在 CMake 命令中添加 --debug-find 查看详细搜索日志：

bash

复制

cmake -DCMAKE_FIND_DEBUG_OUTPUT=ON ..

---

根据具体情况选择合适的方法，通常优先使用 CMAKE_PREFIX_PATH 或包特定的 XXX_DIR。