find_package不是简单“找库”，而是cmake依赖集成的入口开关：它先按cmake_module_path→cmake自带modules目录顺序查找find.cmake（module模式），失败后才在cmake_prefix_path、_dir等路径下查找config.cmake或-config.cmake（config模式）；不加required则静默设*_found为false，必须手动判断；版本与components影响变量生成和链接有效性；路径优先级中_dir高于paths参数。
find_package 不是“找库”这么简单，它是 CMake 依赖集成的入口开关——用错模式、漏掉 REQUIRED、搞混路径顺序，都会导致变量没设上、链接失败、甚至静默跳过。
find_package 找不到包？先看它到底在搜什么文件
它不是直接扫系统目录，而是按固定规则找两类 .cmake 文件：
- 模块模式（默认先试）：找
Find<packagename>.cmake</packagename>，路径优先级是CMAKE_MODULE_PATH→ CMake 自带 Modules 目录（如/usr/share/cmake-3.22/Modules/） - 配置模式（模块找不到时 fallback）：找
<packagename>Config.cmake</packagename>或<lowercase-package-name>-config.cmake</lowercase-package-name>，路径来自CMAKE_PREFIX_PATH、<packagename>_DIR</packagename>环境变量、标准安装前缀（/usr、/usr/local、CMAKE_INSTALL_PREFIX）等
比如 find_package(Eigen3) 实际会依次尝试：FindEigen3.cmake → Eigen3Config.cmake → eigen3-config.cmake。如果都不存在，就真找不到。
REQUIRED 不加，<packagename>_FOUND</packagename> 就得自己判
不写 REQUIRED 时，CMake 永远不会报错，哪怕包根本不存在——它只设 Eigen3_FOUND 为 FALSE，然后继续往下跑。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 必须检查
if(Eigen3_FOUND)，否则target_link_libraries(myapp ${Eigen3_LIBRARIES})会链接空字符串，编译器报错难定位 -
REQUIRED是懒人保障：省去判断，出错立刻停在 configure 阶段，错误信息明确（如Could not find a package configuration file provided by "Eigen3"） - 可选依赖才不加
REQUIRED，比如加日志功能用glog，但主逻辑不依赖它
版本和组件不是可有可无的装饰参数
version 和 COMPONENTS 直接影响查找逻辑和变量内容：
- 写
find_package(Boost 1.70 REQUIRED COMPONENTS system filesystem)，CMake 会要求找到的 Boost 版本 ≥1.70，且必须提供system和filesystem两个组件；缺一个，Boost_FOUND就是FALSE - 不写
COMPONENTS，CMake 可能只加载基础部分（比如只设Boost_INCLUDE_DIRS），但Boost_LIBRARIES为空——因为没指定要哪几个库 -
EXACT很少用：强制要求版本号完全一致（1.70.0≠1.70），容易卡死在 CI 环境
自定义路径别只靠 PATHS，优先设环境变量
想让 find_package(MyLib) 找到你本地编译安装的版本，最可靠的方式不是在 CMakeLists 里硬写路径：
- 设环境变量：
export MyLib_DIR=/path/to/mylib/lib/cmake/MyLib（注意是包含MyLibConfig.cmake的目录，不是lib本身） - 或在命令行传：
cmake -DMyLib_DIR=/path/to/mylib/lib/cmake/MyLib .. -
find_package(MyLib PATHS /path/to/mylib)效果弱：它只加在搜索路径末尾，优先级低于MyLib_DIR和CMAKE_PREFIX_PATH - 若库没提供
*Config.cmake，只能自己写FindMyLib.cmake放进CMAKE_MODULE_PATH，用find_path/find_library手动拼
真正容易被忽略的是：模块模式（Find*.cmake）和配置模式（*Config.cmake）行为差异极大——前者由 CMake 社区维护，后者由库作者生成，变量命名、是否导出 IMPORTED 目标都不同。混用会导致 _LIBRARIES 是字符串还是目标名都搞不清。
