packagename_dir优先级最高，cmake仅在其指定目录下查找config文件；cmake_prefix_path用于批量设置多个库的搜索根目录；no_default_path会禁用所有默认路径；module模式需提前设置cmake_module_path。

find_package 优先级最高的路径是 PackageName_DIR

直接在命令行传入 PackageName_DIR 是最可靠、最优先的指定方式，CMake 会跳过所有其他路径，只在这个目录下找 PackageNameConfig.cmake 或 PackageName-config.cmake。

常见错误是把路径设成库的安装根目录（如 /opt/opencv），但实际应指向包含 Config 文件的子目录（通常是 lib/cmake/opencv 或 share/opencv/cmake）。

• 正确示例：cmake -DOpenCV_DIR=/usr/local/lib/cmake/opencv4 ..
• 错误示例：cmake -DOpenCV_DIR=/usr/local ..（CMake 找不到 Config 文件）
• 如果路径中含空格或特殊字符，必须用引号包裹：-DBoost_DIR="/path/with spaces/boost"
• PackageName_DIR 只影响本次 find_package() 调用，不污染全局环境

用 CMAKE_PREFIX_PATH 批量设置多个库的搜索根目录

当你同时集成多个自编译库（比如 Eigen、glog、protobuf 都装在 ~/deps 下），CMAKE_PREFIX_PATH 比逐个设 _DIR 更干净。

CMake 会依次在 ${CMAKE_PREFIX_PATH}/lib/cmake/<name></name>、${CMAKE_PREFIX_PATH}/share/<name>/cmake</name> 等位置查找 Config 文件。

C++ 算法竞赛自动化测试数据生成与校验框架

根据原题生成新题面、验证器及完整测试数据，自动套用 testlib 模板，用于用户要求生成测试数据时。

下载

• 命令行写法：cmake -DCMAKE_PREFIX_PATH=$HOME/deps ..
• 注意：路径末尾不要加 /lib/cmake —— CMake 自己拼接子路径
• 多个路径用分号分隔（Linux/macOS 用 :，Windows 用 ;），例如：-DCMAKE_PREFIX_PATH="/a;/b"
• 它不影响 find_path() 或 find_library() 的行为，只作用于 find_package() 的 Config 模式

禁用默认路径时小心 NO_DEFAULT_PATH 的副作用

加上 NO_DEFAULT_PATH 后，CMake 不再查 /usr、/usr/local、CMAKE_INSTALL_PREFIX 等系统路径 —— 这能避免误匹配系统旧版本，但也容易“什么也找不到”。

它常和 HINTS 或 PATHS 配合使用，但顺序很重要：CMake 先查 HINTS，再查 PATHS，且都只在你显式列出的路径里搜。

• 安全写法：find_package(Protobuf REQUIRED HINTS ${PROTOBUF_ROOT} NO_DEFAULT_PATH)
• 危险写法：find_package(Protobuf REQUIRED PATHS /wrong/path NO_DEFAULT_PATH)（查不到就直接失败）
• NO_DEFAULT_PATH 会同时禁用 CMAKE_PREFIX_PATH 和 PackageName_DIR —— 它真的“啥都不认”，只信你给的 HINTS/PATHS
• 调试技巧：加 MESSAGE(STATUS "CMAKE_PREFIX_PATH=${CMAKE_PREFIX_PATH}") 确认变量是否生效

模块模式下 CMAKE_MODULE_PATH 必须提前设置

当库没提供 XXXConfig.cmake（比如老版本 Boost 或某些自制库），CMake 会退回到 Module 模式，去查 FindXXX.cmake。此时 CMAKE_MODULE_PATH 决定它去哪找。

这个变量必须在任何 find_package() 调用前设置，否则无效 —— 放在 project() 之后、find_package() 之前是最稳妥的位置。

• 正确顺序：project(MyProj) → set(CMAKE_MODULE_PATH "${CMAKE_SOURCE_DIR}/cmake/modules" ${CMAKE_MODULE_PATH}) → find_package(MyLib)
• CMAKE_MODULE_PATH 是 list 类型，追加时用 ${CMAKE_MODULE_PATH} 保留原有路径
• 自定义 FindXXX.cmake 文件里不能依赖 PackageName_DIR —— Module 模式根本不读这个变量
• 别指望 find_package(MyLib MODULE) 能绕过 Config 模式：它只是强制走 Module 模式，仍要你提供 FindMyLib.cmake

实际工程中最容易被忽略的点是：Config 模式和 Module 模式共享同一套变量命名约定（如 XXX_FOUND），但它们的底层逻辑完全隔离。一个库是否真正“被正确找到”，取决于它走的是哪种模式、以及对应模式下的文件是否存在且无语法错误 —— 而不是你写了 find_package(XXX REQUIRED) 就万事大吉。