结论：find_package(... PATHS /xxx) 仍 not found 是因 CMake 按严格顺序查路径、匹配文件名并验证内容，任一环节失败即跳过；PATHS 优先级低、路径未精准指向 Config 文件所在目录、大小写不一致或 Config 文件残缺均会导致查找失败。
直接说结论：不是加了 PATHS 或设了 *_DIR 就万事大吉，CMake 会按固定顺序查路径、匹配文件名、验证内容，任一环节失败都会“假装没看见”。
为什么 find_package(... PATHS /xxx) 仍然 not found
CMake 的 find_package 在 Config 模式下（即找 *Config.cmake 文件）会严格按顺序检查多个位置，PATHS 只是其中一部分，且优先级低于某些内置路径。常见失效原因包括：
-
PATHS指向的是库安装根目录，但 CMake 实际要找的是/xxx/lib/cmake/xxx/xxxConfig.cmake或/xxx/share/xxx/xxx-config.cmake—— 如果你给的是/xxx，而真实xxxConfig.cmake在/xxx/lib64/cmake/xxx/，它就跳过去了 -
PATHS后面的路径没加NO_DEFAULT_PATH，CMake 仍会先去系统路径（如/usr/lib/cmake）搜一圈，搜不到才轮到你给的路径；而一旦在系统路径里找到一个残缺或版本错的xxxConfig.cmake，它就直接报错退出，根本不会继续往后看 - 你写的包名大小写和实际
Config.cmake文件名不一致，比如文件叫OpenCVConfig.cmake，但写了find_package(opencv REQUIRED)—— Config 模式下也区分大小写
*_DIR 变量到底要设成什么
xxx_DIR 不是随便指向安装目录就行，它必须精确指向包含 xxxConfig.cmake 的那个文件夹。例如：
- 如果你的 yaml-cpp 安装在
/home/user/yaml-cpp-0.8.0，且里面有lib/cmake/yaml-cpp/yaml-cpp-config.cmake，那么应该：set(yaml-cpp_DIR "/home/user/yaml-cpp-0.8.0/lib/cmake/yaml-cpp") - 如果只有
share/yaml-cpp/cmake/yaml-cpp-config.cmake，那就设成share/yaml-cpp/cmake - 设错会导致 CMake 根本不进这个目录，连文件是否存在都不检查
怎么确认你的包到底有没有合格的 Config 文件
别猜，直接查。打开终端，cd 到你认为的安装路径，用 find 找真实存在的配置文件：
find /usr/local -name "*opencv*config.cmake" 2>/dev/null<br>find ~/mylib -name "*Config.cmake" -o -name "*-config.cmake" 2>/dev/null
看到结果后，注意三点：
- 文件名是否和你
find_package()里写的包名完全一致（含大小写） - 该文件是否可读（权限问题常被忽略）
- 打开这个
*Config.cmake文件，第一行通常有set(XXX_VERSION ...)或include(...)，如果内容为空或只有一行注释，说明它不完整，CMake 会跳过
实在不行，绕过 find_package 直接硬配
当 Config 文件缺失、损坏，或你只是临时测试，最稳的方式是跳过查找逻辑，手动指定头文件和库：
- 用
target_include_directories(mytarget PRIVATE /path/to/include)替代include_directories() - 用
target_link_libraries(mytarget PRIVATE /path/to/lib/libxxx.so)或target_link_libraries(mytarget PRIVATE imported_target)（先add_library(xxx IMPORTED)再set_property(TARGET xxx PROPERTY IMPORTED_LOCATION /path/to/lib/libxxx.so)） - 避免用全局
link_directories()—— 它不保证链接顺序，且对现代 CMake 已过时
真正麻烦的从来不是路径写错，而是你以为路径对了，其实 CMake 根本没走到那儿；或者你以为文件存在，其实它只是个空壳。动手前，先 find 一下，比改十遍 CMakeLists.txt 更快。
