CMake的find_package找不到库，核心在于未控制其搜索顺序；应优先用_DIR指定Config.cmake路径，其次用CMAKE_PREFIX_PATH扩展搜索范围，对无Config文件的库则改用find_path+find_library手动定位。
find_package 找不到库？不是路径没写对，而是你没控制它的搜索顺序。CMake 默认只查那几个固定位置，自定义安装路径（比如 /opt/mylib 或 ~/local）它压根不看，除非你主动告诉它。
用 <packagename>_DIR</packagename> 变量指定配置文件所在目录
这是最常用、也最可靠的方式，前提是目标库提供了 XXXConfig.cmake 或 xxx-config.cmake 文件（比如 ProtobufConfig.cmake、OpenCVConfig.cmake）。
- 先确认你的库确实有这类文件：通常在
lib/cmake/<packagename>/</packagename>或share/cmake/<packagename>/</packagename>下 - 在
CMakeLists.txt中find_package之前设置变量，例如：set(Protobuf_DIR "/home/user/libprotobuf/share/cmake/protobuf")<br>find_package(Protobuf REQUIRED)
- 这个变量优先级最高，CMake 会直接去该路径下找
Config.cmake，跳过所有默认路径 - 注意大小写：变量名是
Protobuf_DIR，不是protobuf_DIR；包名大小写必须和find_package调用时一致
用 CMAKE_PREFIX_PATH 扩展全局搜索范围
适合多个包都装在同一前缀目录下（比如你把所有自编译库统一装到 /opt/mydeps），不想为每个包单独设 _DIR 变量。
- 在命令行调用 CMake 时传入：
cmake -DCMAKE_PREFIX_PATH=/opt/mydeps ..
- 或在
CMakeLists.txt开头设置（但不如命令行方式清晰）：set(CMAKE_PREFIX_PATH "/opt/mydeps" ${CMAKE_PREFIX_PATH}) - CMake 会把
/opt/mydeps/lib/cmake/、/opt/mydeps/share/cmake/等路径加入搜索队列 - 它不会替代
_DIR，但能覆盖大部分标准查找逻辑；如果同时设了_DIR，_DIR仍优先
当库根本没有 Config.cmake 文件时
像 Crypto++、zlib 这类轻量库，通常不提供 CMake 配置文件。这时 find_package 会失败，得换方式。
- 改用
find_library+find_path分别找库文件和头文件：find_path(CRYPTOPP_INCLUDE_DIR NAMES cryptopp/cryptlib.h PATHS /opt/cryptopp/include)<br>find_library(CRYPTOPP_LIBRARY NAMES cryptopp PATHS /opt/cryptopp/lib)<br>if(NOT CRYPTOPP_INCLUDE_DIR OR NOT CRYPTOPP_LIBRARY)<br> message(FATAL_ERROR "Crypto++ not found")<br>endif()
- 然后手动设置包含路径和链接目标：
target_include_directories(myapp PRIVATE ${CRYPTOPP_INCLUDE_DIR})<br>target_link_libraries(myapp PRIVATE ${CRYPTOPP_LIBRARY}) - 别再试图让
find_package(CryptoPP REQUIRED)成功——它根本不存在对应配置，硬写只会报Could not find a package configuration file
最容易被忽略的一点：CMake 缓存。改了 _DIR 或 CMAKE_PREFIX_PATH 后，如果之前构建过，CMake 可能还记着旧的缓存结果。务必删掉 build/ 目录或运行 cmake -U 清缓存再试，否则修改根本不会生效。
