CMake中链接第三方库的核心是target_link_libraries，它仅负责告知链接器符号依赖；需先定义目标，再用find_package或绝对路径等方式链接，并注意头文件与库路径的协同配置。
在CMake项目中让可执行文件或库真正用上第三方代码，核心就是通过target_link_libraries把编译产物和目标关联起来——它不负责找头文件、不负责定位路径，只干一件事：告诉链接器“这个目标要链接哪些符号”。
先确认目标已定义
确保你已在CMakeLists.txt中用add_executable或add_library声明了目标，例如：add_executable(myapp main.cpp)。没有目标名，target_link_libraries就无从绑定。
【目标名必须完全一致】：大小写、下划线、拼写错一个字符，链接就会静默失败，生成的可执行文件运行时可能报undefined symbol。
链接系统已安装的库（如OpenCV、fmt）
方法一：用find_package自动探测（推荐）
第一步：调用find_package(OpenCV REQUIRED) → CMake会在标准路径搜索OpenCVConfig.cmake或OpenCVConfig-version.cmake；若找不到会报错终止配置。
第二步：用target_link_libraries(myapp ${OpenCV_LIBS}) → 该变量由find_package填充，含所有必要库名（如opencv_core opencv_imgproc）。
方法二：直接链接导入目标（仅适用于支持Config模式的库）
find_package(fmt CONFIG REQUIRED) → 成功后产生fmt::fmt这样的导入目标。
target_link_libraries(myapp fmt::fmt) → 这种写法自动包含头文件路径和链接选项，无需手动配target_include_directories。
链接本地静态库（.a）或动态库（.so/.dll）
方法一：指定绝对路径链接静态库
target_link_libraries(myapp /home/user/project/third_party/libz.a) → CMake会直接将该归档文件打包进最终二进制，运行时不依赖外部.so。
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
方法二：只写库名，靠link_directories辅助查找
link_directories(/opt/env/lib) → 告诉链接器去这个目录搜-lyaml-cpp。
target_link_libraries(myapp yaml-cpp) → 注意这里不带lib前缀和.so后缀，CMake自动补全。
【link_directories作用范围是全局的，且必须出现在target_link_libraries之前】：位置颠倒会导致链接失败，且该命令不会传递给子目录CMakeLists.txt。
现代写法：头文件+库路径一体化绑定
第一步：用target_include_directories声明头文件位置
target_include_directories(myapp PRIVATE ${CMAKE_SOURCE_DIR}/third_party/redis-plus-plus/include) → PRIVATE表示仅本目标可见，不传递给依赖它的其他目标。
第二步：用target_link_libraries链接库文件本身
target_link_libraries(myapp ${CMAKE_SOURCE_DIR}/third_party/redis-plus-plus/lib/libredis++.a) → 路径写死但可靠，避免环境变量或系统路径干扰。
第三步：如果库有依赖（如redis++依赖hiredis），必须显式列出全部
target_link_libraries(myapp libredis++.a hiredis) → 顺序不能反：被依赖的库放右边，依赖它的放左边，否则链接器找不到符号。
