根本原因是cmake默认不搜索用户自定义路径，解决核心是通过cmake_prefix_path设置搜索前缀或用paths指定find模块位置；需确保config文件存在、路径设置在find_package前且正确配置交叉编译的find_root_path。
find_package 为什么找不到我的库
根本原因通常是 CMake 没在任何地方看到你放库的目录。它默认只查 CMAKE_PREFIX_PATH、系统路径（如 /usr）、以及 Find<name>.cmake</name> 或 <name>Config.cmake</name> 所在的标准位置。你把库解压到 ~/mylibs/opencv-4.8.1，CMake 默认完全无视这个路径。
解决思路不是“教它找”，而是“告诉它去哪找”——核心就两条：改搜索路径，或显式指定 Config 文件位置。
- 优先尝试
CMAKE_PREFIX_PATH：它是最自然、影响最广的方式，适用于大多数 Config-mode 库（如 OpenCV、Boost、PCL） - 次选
PATHS+NO_DEFAULT_PATH：适合临时调试或非标准布局，但容易漏掉依赖项的嵌套路径 - 避免硬编码绝对路径到
find_package(... PATHS ...)，CI 或换机器就挂
CMAKE_PREFIX_PATH 怎么设才生效
它必须在 find_package 调用前设置，且对后续所有 find_package 生效。常见错误是写在 find_package(OpenCV) 后面，或者用 set(CMAKE_PREFIX_PATH "...") 但没加 CACHE 导致子项目覆盖。
推荐写法（放在 project() 后、find_package 前）：
set(CMAKE_PREFIX_PATH "${CMAKE_SOURCE_DIR}/deps/opencv/install" CACHE PATH "Custom prefix paths")
find_package(OpenCV REQUIRED)
注意：CACHE PATH 让它进 CMake GUI / CLI 缓存，方便用户后期修改；路径末尾不加 /lib/cmake/opencv4 —— CMake 会自动在 <pre class="brush:php;toolbar:false;" fix>/lib/cmake/<name></name></pre>、<pre class="brush:php;toolbar:false;" fix>/share/<name></name></pre> 等子目录里找 OpenCVConfig.cmake。
- 多个路径用分号分隔：
set(CMAKE_PREFIX_PATH "/opt/mylib;/home/user/local" CACHE PATH "") - Windows 下路径用正斜杠或双反斜杠，别用单反斜杠（
C:\path是非法字符串） - 如果库是源码编译安装的，确保
make install真的生成了*Config.cmake文件（不是只有FindOpenCV.cmake）
找不到 Config 文件时，怎么 fallback 到 Find 模块
有些老库（如早期 FFmpeg、某些自研模块）只提供 Find<name>.cmake</name>，不带 Config 模式。这时 CMAKE_PREFIX_PATH 无效，得靠 find_package(... PATHS ...) 手动喂路径。
正确写法示例（找自定义 FindMyLib.cmake）：
find_package(MyLib REQUIRED
PATHS "${CMAKE_SOURCE_DIR}/cmake/modules"
NO_DEFAULT_PATH
NO_MODULE # 强制走 Config 模式？不，这里要删掉！保留它反而禁用 Find 模块
)
关键点：
- 删掉
NO_MODULE—— 它会禁止 CMake 加载Find*.cmake，导致你放好文件也白搭 -
NO_DEFAULT_PATH必须加，否则 CMake 还是先去系统路径翻，你的路径可能被忽略 -
PATHS指向的是包含FindMyLib.cmake的目录，不是库文件所在目录 - 若仍失败，运行
cmake -D CMAKE_VERBOSE_MAKEFILE=ON ..看 CMake 实际搜了哪些路径
交叉编译时 find_package 目录指定的陷阱
宿主机和目标机路径混用是最大雷区。比如你在 x86_64 上编译 ARM 程序，却把 /usr/arm-linux-gnueabihf 加进 CMAKE_PREFIX_PATH —— CMake 会试图在宿主机上找这个路径，而不是用工具链描述的 sysroot。
正确做法是让工具链文件接管：
- 在 toolchain file 里设置：
set(CMAKE_FIND_ROOT_PATH "/path/to/sysroot;/path/to/cross-prefixed-install") - 同时设：
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)（只在 root_path 下找库） - 然后把库装到
/path/to/sysroot/usr/local或/path/to/cross-prefixed-install，再让CMAKE_PREFIX_PATH指向后者
直接在主 CMakeLists.txt 里硬塞交叉路径，90% 会导致本地构建失败或链接错位。工具链文件才是唯一可信的上下文来源。
Config 文件里的路径（比如 OpenCVConfig.cmake 里写的 include_directories）如果是绝对路径，很可能指向宿主机，必须用 cmake -DCMAKE_INSTALL_PREFIX=... 重新 install，且 prefix 要落在 CMAKE_FIND_ROOT_PATH 范围内。
