正确配置cmake链接需分四步：先确保目标由add_executable/add_library定义且非alias；再依private/public/interface作用域精准声明依赖传播；接着区分链接cmake目标、导入目标或绝对路径库；最后注意多依赖混合写法中作用域覆盖规则与避免重复链接。
要在CMake中正确配置目标与库的链接关系，避免构建失败、符号未定义或依赖传递错误，必须区分链接项类型、作用域关键字和调用顺序。直接写target_link_libraries(myapp mylib)可能让下游目标意外获得不该暴露的依赖，也可能导致静态库未被拉入链接器输入列表。
基础写法：先确保目标存在且非ALIAS
第一步：确认<strong>【target】</strong>是由<code>add_executable()或add_library()明确定义的，不能是add_library(mylib ALIAS otherlib)这类别名目标——CMake会报错“target is not a valid target name”。
第二步：在target_link_libraries()之前完成目标定义。例如：add_executable(app main.cpp)必须出现在target_link_libraries(app PRIVATE mylib)之前；若颠倒顺序，CMake解析时找不到app，直接终止配置过程。
作用域关键字怎么选：PRIVATE/PUBLIC/INTERFACE
方法一：用PUBLIC——当你的库既自己用该依赖，又要求所有链接它的目标也必须链接它。比如mylib头文件里用了Boost::system的类型声明，那么使用者编译时必须有Boost::system的头文件和链接项，否则#include "mylib.h"会失败。
方法二：用PRIVATE——仅内部实现需要，不暴露接口。典型如日志库spdlog::spdlog只在.cpp里调用spdlog::info()，头文件里完全不提它，那下游目标完全不需要知道这个依赖。
方法三：用INTERFACE——目标自身不链接也不编译，但强制消费者满足条件。例如纯头文件库math_utils要求C++17支持：target_link_libraries(math_utils INTERFACE cxx_std_17)。此时math_utils本身不生成任何二进制，但任何target_link_libraries(app PRIVATE math_utils)都会让app自动启用-std=c++17。
链接项类型与写法差异
① 链接CMake目标（推荐）：target_link_libraries(app PRIVATE mylib)。CMake自动处理路径、排序依赖和导出属性，无需手动指定-L或-l。
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
② 链接导入目标（第三方库常用）：find_package(OpenSSL REQUIRED)后写target_link_libraries(app PRIVATE OpenSSL::SSL OpenSSL::Crypto)。这比写/usr/lib/libssl.a更可靠，能跨平台适配不同安装路径。
③ 链接绝对路径库文件（慎用）：target_link_libraries(app PRIVATE /opt/mylib/libmylib.a)。这种写法破坏可移植性，且CMake无法为其添加排序依赖——如果libmylib.a还没构建完，链接就会失败。
【绝对路径库必须确保构建前已存在，且不在CMake生成的构建系统管理范围内】
多依赖混合写法与顺序规则
第一步：同一行可混合多个作用域和项：target_link_libraries(app PRIVATE spdlog::spdlog PUBLIC Boost::filesystem INTERFACE cxx_std_17)。
第二步：多次调用等价于追加，但顺序影响依赖传播优先级。例如：target_link_libraries(app PUBLIC A)后再写target_link_libraries(app PRIVATE B)，则A的PUBLIC属性仍生效，B仅私有；但若先写PRIVATE A再写PUBLIC A，后者会覆盖前者的作用域声明。
第三步：避免在不同位置重复链接同一目标。比如app → core → utils链路中，若core已用PUBLIC utils，则app无需再显式链接utils——否则CMake警告“duplicate link item”，且可能引发链接器重复符号错误。
