优先插队方式是设置_dir变量，如yaml-cpp_dir，cmake会将其作为根目录优先查找yaml-cpp-config.cmake等配置文件，该变量非空时直接跳过其他路径。
怎么让 find_package 优先找我自己的库？
关键不是“改默认路径”，而是**插队**——把你的路径塞进最高优先级位置。CMake 的搜索顺序是硬编码的，你没法删掉系统路径，但可以靠变量让它先查你指定的地方。
最直接有效的方式是设置 <packagename>_DIR</packagename> 变量（注意大小写和下划线）。比如你要找 yaml-cpp，就设 yaml-cpp_DIR；找 OpenCV，就设 OpenCV_DIR。这个变量一旦非空，CMake 就会把它当作根目录，只在它下面找 yaml-cpp-config.cmake 或 OpenCVConfig.cmake。
- 命令行传入（推荐，不污染 CMakeLists.txt）：
cmake -Dyaml-cpp_DIR=/path/to/your/yaml-cpp/lib/cmake/yaml-cpp .. - CMakeLists.txt 里提前设（仅限开发调试）：
set(yaml-cpp_DIR "/path/to/your/yaml-cpp/lib/cmake/yaml-cpp")，必须放在find_package(yaml-cpp ...)之前 - 环境变量也行（慎用，影响全局）：
export yaml_cpp_DIR=/path/to/...，注意变量名中连字符会被转成下划线
CMAKE_PREFIX_PATH 和 CMAKE_MODULE_PATH 有什么区别？
两者都是“插路径”的方式，但作用对象完全不同，混用会导致找不到包。
CMAKE_PREFIX_PATH 是给 Config 模式用的，它是一组**根目录**（类似 /usr、/opt/mylib），CMake 会在每个根目录下自动拼出 lib/cmake/<name>/</name>、share/<name>/</name> 等子路径去找 <name>Config.cmake</name>。适合你把整个第三方库装在一个干净前缀下（如 /home/user/mydeps）。
CMAKE_MODULE_PATH 是给 Module 模式用的，它是一组**精确到 .cmake 文件所在目录**的路径（比如 ${PROJECT_SOURCE_DIR}/cmake），CMake 直接在这里找 Find<name>.cmake</name>。适合你自己写了或下载了 FindXXX.cmake 文件。
- Module 模式只认
CMAKE_MODULE_PATH和 CMake 自带 Modules 目录，完全无视CMAKE_PREFIX_PATH - Config 模式优先看
<name>_DIR</name>，其次才轮到CMAKE_PREFIX_PATH，根本不用CMAKE_MODULE_PATH - 如果同时用了
find_package(XXX MODULE)和CMAKE_PREFIX_PATH，后者会被忽略
为什么 find_package(XXX REQUIRED) 还是报错“not found”？
常见原因不是路径没设对，而是路径下压根没有 CMake 能识别的配置文件。
Config 模式要求路径里必须存在 XXXConfig.cmake 或 xxx-config.cmake（注意大小写和连字符），而且该文件得能正常执行（比如不缺依赖、不报语法错误）。很多源码编译安装的库默认不生成这个文件——除非你加了 -DBUILD_SHARED_LIBS=ON -DCMAKE_INSTALL_PREFIX=... 并执行了 make install。
- 检查路径是否真有 config 文件：
ls -l $YOUR_PATH/lib/cmake/xxx/xxx*config* - 确认文件名匹配：OpenCV 安装后通常是
OpenCVConfig.cmake，而 yaml-cpp 是yaml-cpp-config.cmake - 如果只有头文件和 .so，没 config 文件，别硬用
find_package，改用find_path+find_library手动定位 - 加
NO_DEFAULT_PATH参数时务必确保路径 100% 正确，否则 CMake 连 /usr 都不查，容易误判
如何强制只走 Config 模式，跳过 Module 模式？
默认行为是先 Module 后 Config，但很多现代库（如 spdlog、protobuf）只提供 Config 文件，Module 文件根本不存在。这时 Module 阶段纯属浪费时间，还可能因自带的 FindXXX.cmake 逻辑过时导致误报。
显式加 CONFIG 参数即可关闭 Module 模式：
find_package(yaml-cpp 1.12 REQUIRED CONFIG)
这样 CMake 就只查 yaml-cpp-config.cmake，不会去翻 Findyaml-cpp.cmake。配合 NO_DEFAULT_PATH 使用更安全：
set(yaml-cpp_DIR "/path/to/install/lib/cmake/yaml-cpp") find_package(yaml-cpp 1.12 REQUIRED CONFIG NO_DEFAULT_PATH)
注意：MODULE 和 CONFIG 互斥，不能同时出现；加了 CONFIG 后 CMAKE_MODULE_PATH 就彻底失效了。
真正麻烦的不是路径怎么填，而是搞清你手里的库到底提供了哪种模式的文件——打开它的安装目录翻一翻，比背参数有用得多。
