CMake链接失败主因是库路径未识别、库名拼错或未找到库文件；须先声明目标再链接，用find_package导出的target名，link_directories需在目标前调用，推荐find_library精准定位库。
当你在CMakeLists.txt里写完target_link_libraries(myapp foo)却收到undefined reference或library not found报错时，问题几乎总出在库路径没被识别、库名拼错、或CMake根本没找到那个库文件——不是代码逻辑错，是链接这一步断在了门口。
确认目标是否已声明
第一步：检查target_link_libraries是否写在add_executable或add_library之后。
如果写在前面，CMake会直接报错CMake Error: target "myapp" does not exist，连库路径都懒得查——它根本不知道myapp是什么。
必须严格按顺序：先定义目标 → 再链接库。中间不能穿插其他未关联目标的操作。
验证库名是否真实存在
方法一：用find_package加载后查导出的target名
运行find_package(OpenCV REQUIRED)后，不要直接写target_link_libraries(myapp opencv_core)——现代OpenCV导出的是OpenCV::opencv_core，大小写和双冒号缺一不可。
方法二：查看第三方库安装后生成的config.cmake文件
比如yaml-cpp装在/usr/lib/x86_64-linux-gnu/cmake/yaml-cpp/下，打开yaml-cppConfig.cmake，搜索add_library或export，里面声明的target名才是你该用的，例如yaml_cpp::yaml-cpp。
【裸库名仅适用于系统库或自建库】，像m、pthread这种可直接写；但只要用了find_package，就必须用它导出的imported target，不能自己“猜”名字。
检查lib路径是否生效
第一步：确认link_directories()调用位置
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
它必须出现在add_executable()或add_library()之前，否则无效。CMake不会回溯补救——写在后面等于没写。
第二步：用find_library()代替link_directories() + 裸库名
写find_library(MYLIB_LIB NAMES mylib HINTS ${CMAKE_CURRENT_SOURCE_DIR}/libs)，再target_link_libraries(myapp ${MYLIB_LIB})。这样CMake会明确知道你要链接哪个文件，而不是靠路径模糊匹配。
第三步：验证库文件是否存在且架构匹配
执行ls -l /path/to/your/libmylib.so，确认文件可读；再用file /path/to/your/libmylib.so看是不是x86_64（或你当前构建的目标架构）。ARM库丢进x86_64项目里，CMake能找到路径也链接失败。
快速定位缺失库的物理位置
方法1：用find_library加NO_DEFAULT_PATH强制限定范围
避免CMake在系统路径里瞎找一通还优先返回旧版本。写成：find_library(FOO_LIB NAMES foo PATHS ${PROJECT_SOURCE_DIR}/3rdparty/lib NO_DEFAULT_PATH)，这样它只在你指定目录里找，找不到就报错，不兜底。
方法2：手动验证库文件能否被链接器读取
运行ld -L/path/to/lib -lfoo --verbose 2>/dev/null | grep "attempt"，如果输出里没有found libfoo，说明路径或文件名不对——这时再回头改HINTS或NAMES参数比硬调CMake更省时间。
