find_package找不到库是因为缺失xxxconfig.cmake文件，系统包管理器安装的旧版库通常不提供该文件；应优先检查是否真安装对应库，再选择module模式、补全findxxx.cmake或从源码构建并设置cmake_prefix_path。
find_package 找不到库，报错 “Could not find a package configuration file”
这不是你写错了路径，而是 CMake 在 CONFIG 模式下找不到 XXXConfig.cmake 或 xxx-config.cmake 文件。系统包管理器（如 apt）装的旧版库通常只提供头文件和 .so/.a，不带现代 CMake 配置文件。
- 先确认是否真装了对应库：
dpkg -L libgrpc++-dev（Debian/Ubuntu）或rpm -ql grpc-devel（RHEL），看目录里有没有*Config.cmake - 若没有，别硬改
find_package(gRPC REQUIRED)，改用find_package(gRPC CONFIG REQUIRED NO_MODULE)会失败得更明确；更稳妥的是切换为 MODULE 模式：find_package(gRPC REQUIRED MODULE)，但需确保有FindgRPC.cmake（可从 cmake-modules 或自己补） - 终极方案：从源码构建 gRPC 并启用
-DBUILD_SHARED_LIBS=ON -DCMAKE_INSTALL_PREFIX=/opt/grpc，再在项目中加set(CMAKE_PREFIX_PATH "/opt/grpc")
target_link_libraries 链接失败，报 “undefined reference to …”
符号没找到，90% 是链接顺序或作用域问题，不是头文件包含或编译问题。
-
target_link_libraries(myapp PRIVATE mylib)中的mylib必须是已定义的 target（比如用add_library(mylib ...)声明过），不能是路径字符串或变量名 - 第三方库如 fmt、OpenMP，必须用导入目标形式：
find_package(FMT REQUIRED)后写target_link_libraries(myapp PRIVATE fmt::fmt)，而不是${FMT_LIBRARIES} - 如果用了
set(LIBS "/path/a.so;/path/b.so" CACHE STRING "")，直接${LIBS}传给target_link_libraries会失败——CMake 把它当单个字符串，不是列表；应改用list(STRINGS LIB_LIST ${LIBS})或更推荐：用find_library+imported target
Android Studio 中链接系统库失败，log-lib 找不到
不是 find_library 写错了，而是 NDK 版本或 ABI 配置不匹配导致 CMake 搜索路径失效。
-
find_library(log-lib log)实际查的是${ANDROID_NDK}/platforms/android-${ANDROID_PLATFORM}/arch-${ARCH}/usr/lib/liblog.so，所以必须确保android.defaultConfig.ndk.abiFilters和当前构建 ABI 一致 - 检查
ANDROID_PLATFORM是否设得太低（如android-16），而 log 库在更高平台才稳定支持；建议设为android-21或以上 - 如果仍报错，手动指定路径验证：
find_library(log-lib log PATHS ${ANDROID_NDK}/platforms/android-21/arch-arm64/usr/lib)，成功后再还原为自动查找
CLion 里 CMake configure 成功但 build 失败，提示 “No rule to make target src/main.cpp”
configure 阶段没报错，不代表路径有效——CMake 只校验语法，不校验文件是否存在；真正出问题在构建阶段。
- 检查
add_executable(app src/main.cpp)中的src/main.cpp是否真实存在，注意 CLion 默认新建项目时生成的是main.cpp在根目录，不是src/下 - 若用了
file(GLOB SRC_FILES "src/*.cpp")，记得加set(SRC_FILES ${SRC_FILES} PARENT_SCOPE)或直接在add_executable中展开，否则变量作用域外为空 - CLion 的 Project Structure → C++ Standard 要和
set(CMAKE_CXX_STANDARD 17)保持一致，否则可能触发隐式重配置，导致缓存路径错乱
cmake --debug-output 看它到底在搜什么路径、展开了哪些变量。
