CMAKE_PREFIX_PATH需设为库安装根目录而非Config.cmake所在路径，多个路径用分号（Windows）或冒号（Unix）分隔，支持命令行-D、CMakeLists.txt中set、环境变量三种设置方式，且必须在find_package前生效。
find_package 指定绝对路径时 CMAKE_PREFIX_PATH 怎么设
直接写绝对路径给 find_package 是无效的——它不接受路径参数，只能靠环境或变量引导查找逻辑。真正起作用的是 CMAKE_PREFIX_PATH，它是一组根目录列表，CMake 会在每个目录下按固定子路径（如 lib/cmake/PackageName/ 或 share/cmake/PackageName/）搜索 PackageNameConfig.cmake 或 FindPackageName.cmake。
设置方式有三种，按优先级从高到低：
- 命令行传入：
cmake -DCMAKE_PREFIX_PATH=/opt/mylib .. - CMakeLists.txt 中提前 set（必须在
find_package之前）：set(CMAKE_PREFIX_PATH "/opt/mylib" ${CMAKE_PREFIX_PATH}) - 环境变量（Linux/macOS）：
export CMAKE_PREFIX_PATH="/opt/mylib"；Windows 用set CMAKE_PREFIX_PATH=C:mylib
注意：多个路径用分号分隔（Windows）或冒号分隔（Unix），但推荐统一用 list(APPEND ...) 避免平台差异。
为什么 /usr/local/lib/cmake/xxx 不生效
常见错觉是“把 Config.cmake 放进某个 lib/cmake 目录就自动被找到”，其实 CMake 只认 CMAKE_PREFIX_PATH 下的 lib/cmake/PackageName 或 share/cmake/PackageName，而不是任意路径下的同名子目录。
比如你把 MyLibConfig.cmake 放在 /usr/local/lib/cmake/mylib/，那 CMAKE_PREFIX_PATH 必须设为 /usr/local，不是 /usr/local/lib/cmake/mylib。
验证是否命中：开启调试输出 cmake -DCMAKE_FIND_DEBUG_MODE=ON ..，它会打印所有尝试的路径，一眼看出漏了哪层。
- 路径末尾不要加斜杠（
/opt/mylib/和/opt/mylib效果一样，但前者易引发拼接错误） - 如果库安装结构特殊（比如 Config.cmake 在
install/share/），就把CMAKE_PREFIX_PATH指向install目录，不是install/share -
find_package(MyLib REQUIRED)找不到时，先确认MyLibConfig.cmake文件是否存在、命名是否匹配（大小写敏感）、是否可读
find_package 的 NO_MODULE 和 CONFIG 模式区别
默认行为是先找 Config 模式（PackageNameConfig.cmake），找不到再 fallback 到 Module 模式（FindPackageName.cmake）。但如果你明确只想用 Config 模式，避免误加载系统自带的 FindXXX.cmake，必须显式加 CONFIG：
find_package(MyLib CONFIG REQUIRED)
否则即使你设置了 CMAKE_PREFIX_PATH，CMake 也可能跳过你的 Config 文件，转而用 /usr/share/cmake/Modules/ 下的 FindMyLib.cmake（尤其当名字碰巧一致时）。
-
NO_MODULE等价于CONFIG，两者选其一即可 - 加
CONFIG后，CMAKE_PREFIX_PATH只影响 Config 模式查找，Module 模式完全忽略它 - 某些第三方库（如 OpenCV）提供两种模式，但自建库一般只提供 Config 模式，此时不加
CONFIG反而容易出错
Windows 上路径写法和反斜杠陷阱
Windows 路径在 CMake 里必须用正斜杠或双反斜杠，单反斜杠会被当作转义符处理：
- ✅ 正确：
CMAKE_PREFIX_PATH="C:/mylib"或CMAKE_PREFIX_PATH="C:\mylib" - ❌ 错误：
CMAKE_PREFIX_PATH="C:mylib"——m被解析成不可见字符，路径截断
命令行设置时，PowerShell 和 CMD 行为不同：CMD 接受双反斜杠，PowerShell 更推荐正斜杠。最稳的方式是统一用正斜杠，CMake 全平台兼容。
另外，Windows 上常见问题是路径含空格（如 C:/Program Files/mylib），此时命令行传参必须加英文双引号，且引号内不能混用单引号；CMakeLists.txt 中用 set() 则无需额外处理。
跨平台项目建议始终用 file(TO_CMAKE_PATH "...") 转换路径，它能自动标准化分隔符和空格转义。
