必须清理缓存，否则find_package会忽略新指定目录，因其查找结果（是否找到、路径、Config.cmake）默认缓存至CMakeCache.txt；一旦成功找到，后续cmake直接读缓存，不再扫描新设路径。
必须清理缓存，否则 find_package 会忽略你新指定的目录
为什么改了 _DIR 或 CMAKE_PREFIX_PATH 还是找不到包？
因为 find_package 的查找结果（包括是否找到、找到哪个路径、加载了哪个 Config.cmake）默认全部缓存进 CMakeCache.txt。一旦某个包被成功找到过，后续运行 cmake 时，它直接读缓存返回旧结果，根本不会重新扫描你新设的路径。
常见错误现象：
- 明明设置了
-DOpenCV_DIR=/my/custom/opencv/build，但OpenCV_FOUND仍是FALSE，或仍指向系统旧版本 - 修改了
CMAKE_PREFIX_PATH环境变量或在CMakeLists.txt中list(APPEND CMAKE_PREFIX_PATH ...)，但find_package(ffmpeg)行为没变化 - 切换不同构建目录（如从
build-debug切到build-release），却复用了旧缓存里的路径判断
哪些操作触发缓存失效？哪些不触发？
缓存不是靠“路径变了”自动更新的，而是靠“变量值变了”且该变量参与了查找逻辑。但 CMake 不会主动检测外部路径内容变化，只认缓存里存的值。
- ✅ 显式清除缓存：删掉
build/CMakeCache.txt，或整个build/目录 - ✅ 第一次运行 cmake（无缓存可读）
- ❌ 仅修改
CMakeLists.txt中的set(CMAKE_PREFIX_PATH ...)—— 缓存里已存有OpenCV_DIR或OpenCV_FOUND，CMake 优先用缓存值 - ❌ 仅传入新
-Dxxx_DIR=...参数但缓存中已有同名变量（且非FORCE）—— CMake 默认不覆盖已有缓存项
怎么安全地换目录并让 find_package 生效？
最稳妥的做法是：每次显式指定查找路径时，强制刷新相关缓存项。不要依赖“可能生效”的隐式行为。
- 删缓存文件：
rm build/CMakeCache.txt，再跑cmake -B build -DOpenCV_DIR=/path/to/my/opencv - 用
FORCE覆盖缓存变量（适合脚本化）：cmake -B build -DOpenCV_DIR:PATH=/path/to/my/opencv -DOpenCV_DIR:FORCE=true - 避免混用方式：别在一个项目里既设
OpenCV_DIR又在CMakeLists.txt里set(CMAKE_PREFIX_PATH ...)，容易互相干扰 - 确认是否真生效：加一行
message(STATUS "OpenCV_DIR = ${OpenCV_DIR}")和message(STATUS "OpenCV_FOUND = ${OpenCV_FOUND}")，看输出是否符合预期
缓存机制对跨平台和 CI 构建的影响
本地开发时缓存能提速，但在 CI 流水线或 Docker 构建中，缓存反而成隐患。比如：
- Docker 构建层缓存了旧
CMakeCache.txt，导致新镜像仍链接旧库 - CI runner 复用 build 目录，上一次失败的
find_package缓存（xxx_NOTFOUND）被沿用，新配置无法触发重试
所以 CI 脚本里应默认加 rm -f build/CMakeCache.txt 或直接用干净目录（cmake -B build-clean ...）。缓存不是“省事”，而是“省时间”——前提是时间省得对。
