应通过CMAKE_PREFIX_PATH或<PackageName>_DIR变量指定路径，而非修改find_package()参数；CMAKE_PREFIX_PATH全局生效，<PackageName>_DIR精准控制单库；需确保变量设置在find_package前且路径指向Config.cmake所在目录。
find_package 时怎么指定第三方库的安装路径？
直接在 find_package() 前用 CMAKE_PREFIX_PATH 或 xxx_DIR 变量告诉 CMake 去哪找，而不是改 find_package() 的参数本身。
常见错误是试图写成 find_package(OpenSSL PATH /opt/openssl) —— 这语法根本不存在，CMake 会报错 Unknown argument PATH。
-
CMAKE_PREFIX_PATH是最通用的方式：它像环境变量，影响所有后续find_package()调用。适合整个项目统一指定路径，比如cmake -DCMAKE_PREFIX_PATH=/opt/mydeps .. - 对单个库更精准的控制，用
<PackageName>_DIR，比如OpenSSL_DIR、Protobuf_DIR。必须指向包含XXXConfig.cmake或FindXXX.cmake的目录（通常是/path/lib/cmake/openssl/或/path/share/openssl/） - 如果库只有
FindXXX.cmake（非 Config 模式），XXX_DIR应指向该脚本所在目录，且需确保脚本里find_path/find_library的搜索路径已适配你的安装结构
为什么 set(OpenSSL_DIR ...) 有时不生效？
顺序决定一切：set(OpenSSL_DIR ...) 必须放在 find_package(OpenSSL) 之前，且不能在 project() 之后才设置（某些旧版 CMake 在 project() 后会重置部分变量）。
另一个坑是路径值不对：比如你装在 /opt/openssl-1.1.1w，但 OpenSSL_DIR 设成了 /opt/openssl-1.1.1w，而实际 OpenSSLConfig.cmake 在 /opt/openssl-1.1.1w/lib/cmake/openssl/ 里 —— 正确值应是后者。
- 运行
find_package(OpenSSL REQUIRED)前加message(STATUS "OpenSSL_DIR = ${OpenSSL_DIR}")确认变量值 - 用
ls -l /your/path/lib/cmake/openssl/检查是否存在OpenSSLConfig.cmake或openssl-config.cmake - 若只有
FindOpenSSL.cmake，CMake 默认在CMAKE_MODULE_PATH里找，此时应list(APPEND CMAKE_MODULE_PATH "/your/custom/modules")
交叉编译时 find_package 找不到本地库怎么办？
交叉编译工具链自带的 find_package 逻辑默认搜目标平台路径（如 /usr/arm-linux-gnueabihf/），不会理你主机上的 /opt/mylib。必须显式切断默认行为。
- 设置
CMAKE_FIND_ROOT_PATH指向你的 sysroot（如/opt/arm-sysroot），并设CMAKE_FIND_ROOT_PATH_MODE_*为ONLY，让 CMake 只在该路径下找 - 同时把第三方库装进这个 sysroot 里（例如
/opt/arm-sysroot/usr/local/），再用CMAKE_PREFIX_PATH=/opt/arm-sysroot/usr/local - 避免混用：不要一边设
CMAKE_PREFIX_PATH指向主机路径，一边又用CMAKE_FIND_ROOT_PATH，否则可能搜到主机头文件却链接目标平台库，导致 ABI 不匹配
find_package 找到旧版本库，如何强制用新版本？
CMake 默认选找到的第一个满足版本要求的库，不会自动选最新。要锁定版本，得靠 VERSION 和 EXACT 参数，或用 REQUIRED 配合严格版本号。
- 写成
find_package(Protobuf 3.21.12 EXACT REQUIRED)，CMake 会拒绝 3.21.11 或 3.22.0 - 如果库没提供
ProtobufConfig.cmake（只靠FindProtobuf.cmake），版本检查能力弱，此时更依赖Protobuf_DIR指向正确版本的安装目录 - 运行时加
-DProtobuf_DIR=/path/to/protobuf-3.21.12/lib/cmake/protobuf比改 CMakeLists.txt 更快验证是否真用了新版本
路径拼写、变量设置时机、sysroot 隔离、版本语义 —— 这四点漏掉任何一环都可能让 find_package 默默退回到系统自带库，还不好 debug。
