结论是：应避免使用include_directories和link_directories全局设置路径，优先采用find_package或fetchcontent引入依赖，并通过target_link_libraries和target_include_directories将头文件与库精准绑定到具体目标；find_package是否可用取决于目标库是否提供xxxconfig.cmake文件，有则用config模式直接链接导入目标，无则需回退至module模式或手动处理。
直接说结论：别用 include_directories 和 link_directories 全局塞路径，优先用 find_package 或 FetchContent，再配合 target_link_libraries 和 target_include_directories 绑定到具体目标。
find_package 找不到库？先确认它有没有 Config 模式支持
不是所有库都能靠 find_package(XXX) 一键搞定。关键看它是否提供 XXXConfig.cmake 文件（通常随源码或包管理器安装一起提供）。
- 有 Config 模式（如
fmt、Eigen、OpenCV 4.5+）：直接find_package(fmt CONFIG REQUIRED)，然后target_link_libraries(myapp PRIVATE fmt::fmt) - 只有 Module 模式（如老版本 OpenCV、Boost）：CMake 自带
FindXXX.cmake，但可靠性低，容易漏组件，得手动补find_package_handle_standard_args做校验 - 完全没配置文件（比如你本地编译的私有库）：别硬套
find_package，换add_subdirectory或手动target_link_libraries
查不到时，运行 cmake -D CMAKE_VERBOSE_MAKEFILE=ON .. 看实际搜索路径，再用 CMAKE_PREFIX_PATH 补充，比如 set(CMAKE_PREFIX_PATH "/opt/openssl" ${CMAKE_PREFIX_PATH})。
FetchContent 拉取头文件库，为什么加了还是报 “no such file”？
FetchContent 只下载并解压源码，不自动暴露头文件路径——它不会帮你改 target_include_directories。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 必须显式调用
target_include_directories(myapp PRIVATE ${fmt_SOURCE_DIR}/include)，否则预处理器根本找不到<fmt></fmt> - 如果库用了
INTERFACE目标（如fmt::fmt-header-only），就不用手写路径，直接target_link_libraries(myapp PRIVATE fmt::fmt-header-only) -
GIT_TAG务必用稳定 tag（如10.2.1），别用main分支——CI 构建会因 commit 漂移失败
target_link_libraries 链错了静态库，运行时报 “undefined symbol”？
链接顺序和作用域搞错是常见原因。静态库 A 依赖 B，但你只链了 A，没链 B，符号就解析不了。
- 确保依赖链完整：
target_link_libraries(myapp PRIVATE libA.a libB.a)，且 A 在 B 前面（从左到右解析） - 作用域选错会导致下游目标看不到接口：
PUBLIC才会让依赖它的 target 自动继承头文件路径和 compile definitions - 动态库要注意运行时路径：Linux 下用
LD_LIBRARY_PATH，macOS 用DYLD_LIBRARY_PATH，Windows 把.dll放进可执行目录或系统 PATH
Windows 下链接 .lib 却提示 “LNK2019: unresolved external symbol”？
这往往不是路径问题，而是 ABI 不匹配或导出符号缺失。
- 检查编译器和运行时库一致：你的项目用 MSVC v143（VS2022），第三方
.lib也得是同一工具集编译的，混用 v142/v143 会炸 - 确认库是“导入库”（import library），不是“存档库”（archive library）；后者需要
add_library(... STATIC IMPORTED)+set_property显式指定IMPORTED_LOCATION - 若库由 DLL 导出，确保头文件里用了
__declspec(dllimport)，否则链接器找不到符号
最易被忽略的是 C++ 标准和字符集：一个用 /std:c++17，另一个用 /std:c++20，或者一个开 /MD（动态 CRT），另一个用 /MT（静态 CRT），都会导致符号名不匹配，连错误信息都看不出端倪。
