target_link_libraries顺序错误会导致链接失败，静态库依赖关系要求被依赖库（底层）置于右侧、依赖库（上层）置于左侧；find_package默认不找.a文件，需手动add_library导入并设置路径与头文件；Windows下.lib需区分静态库与导入库。
target_link_libraries 顺序错，链接就失败
静态库之间有依赖关系时，target_link_libraries 的顺序不是随便写的。CMake 会按你写的顺序从左到右解析符号引用，如果 libA.a 依赖 libB.a 里的函数，那 libA.a 必须写在 libB.a 前面——否则链接器找不到 libB.a 提供的符号，报 undefined reference。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 把被依赖的库（底层库）放在列表右侧，依赖它的库（上层库）放左侧
- 如果多个库互有依赖，考虑用
target_link_libraries(my_target PRIVATE ${LIBS} ${LIBS})重复一次，或改用-Wl,--no-as-needed（不推荐，掩盖设计问题） - 用
nm -C libX.a | grep "SomeSymbol"确认符号是否存在，避免盲目调序
find_package 找不到 .a 文件，得手动指定路径
CMake 默认的 find_package 行为优先找动态库（.so/.dylib/.dll），即使你只放了 .a，它也可能静默跳过或报 NOTFOUND。这不是 bug，是设计使然：CMake 认为“package”应提供完整接口，而静态库通常不带配套的 *Config.cmake 或 FindXXX.cmake。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 不用
find_package，直接用add_library导入静态库：add_library(thirdparty STATIC IMPORTED)，再用set_property(TARGET thirdparty PROPERTY IMPORTED_LOCATION /path/to/libxxx.a) - 如果必须用
find_package，加CONFIG和NO_MODULE，并确保第三方提供了xxxConfig.cmake（常见于 vcpkg/conan 安装的包） - 检查
CMAKE_FIND_LIBRARY_SUFFIXES是否包含.a：list(APPEND CMAKE_FIND_LIBRARY_SUFFIXES ".a")，但仅对find_library有效
STATIC 库传给 target_link_libraries 时，别漏掉 INTERFACE_INCLUDE_DIRECTORIES
静态库本身不打包头文件路径。你用 target_link_libraries(my_exe PRIVATE libA.a) 后，编译 my_exe 源码时仍会报 fatal error: xxx.h: No such file or directory——因为 CMake 不自动传播头文件搜索路径。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 对每个导入的静态库，手动补
target_include_directories：target_include_directories(libA INTERFACE /path/to/headers) - 如果用
add_library(... IMPORTED)，必须显式设置INTERFACE_INCLUDE_DIRECTORIES属性，否则下游无法继承 - 别指望
find_package(... REQUIRED)自动搞定 include 路径——除非它的 Config.cmake 显式调用了target_include_directories
Windows 下 .lib 是静态库，但和 Linux 的 .a 行为不完全等价
Windows 的 .lib 分两种：一种是静态库（内容同 .a），一种是导入库（仅含 DLL 符号表）。CMake 默认不区分，add_library(xxx STATIC IMPORTED) 在 Windows 上可能误绑到 DLL 导入库，导致运行时报 LNK2019 或崩溃。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用
dumpbin /headers xxx.lib查看：若含archive字样，才是真静态库；若含import library，就得换真正的.lib或改用SHARED - 跨平台项目中，避免硬编码
.lib或.a，用find_library+CMAKE_STATIC_LIBRARY_SUFFIX更稳妥 - MinGW 环境下注意：它用
.a，但部分预编译 Windows 库只提供.lib，需用llvm-lib或gendef + dlltool转换
最麻烦的不是链接本身，而是静态库没附带符号表、没导出头文件路径、没说明依赖拓扑。与其反复调 target_link_libraries 顺序，不如先用 ar -t 或 7z l 看清 .a 里到底有什么。
