target_link_libraries 用于声明目标的库依赖及传递性：PRIVATE 仅本目标链接，PUBLIC 同时传递依赖和接口，INTERFACE 仅传递不链接；参数顺序必须为作用域在前、库名在后；需确保库为目标而非 ALIAS，优先用 find_package 而非绝对路径。
target_link_libraries 不是用来“把库文件硬塞进链接命令”的，而是告诉 CMake：这个目标（比如可执行文件或库）在编译后链接阶段**必须依赖哪些库**，以及这些依赖**要不要传给它的下游消费者**。
target_link_libraries 的参数顺序和作用域必须写对
错误写法：target_link_libraries(myapp mylib PRIVATE) —— PRIVATE 必须放在 mylib 前面，否则 CMake 会当成库名解析，报错 Unknown argument "PRIVATE"。
-
target_link_libraries(myapp PRIVATE mylib)：只让myapp链mylib，myapp的调用者（比如另一个可执行文件链接了myapp）看不到这个依赖 -
target_link_libraries(myapp PUBLIC mylib)：myapp自己用，且任何链接myapp的目标（比如test_app）也自动获得mylib的链接和头文件/宏定义（如果mylib用PUBLIC暴露了这些） -
target_link_libraries(myapp INTERFACE mylib)：myapp自身不链接mylib，但所有链接myapp的目标必须链接mylib（典型用于纯头文件库或接口层封装）
链接自己写的库时，add_library 和 target_link_libraries 必须匹配
如果你用 add_library(mylib SHARED ...) 创建了一个共享库，却在 target_link_libraries(myapp PRIVATE mylib) 中引用它，CMake 能正常工作；但如果 mylib 是 INTERFACE 库或 ALIAS 目标，target_link_libraries 就会失败——因为 ALIAS 目标不能作为 target_link_libraries 右侧的 item。
- 确保
mylib是由add_library()或add_executable()创建的真实目标（非ALIAS） - 如果
mylib在子目录中定义，target_link_libraries(myapp PRIVATE mylib)依然有效，CMake 支持跨目录引用 - 重复调用
target_link_libraries(myapp PRIVATE a) target_link_libraries(myapp PRIVATE b)等价于target_link_libraries(myapp PRIVATE a b)，顺序保留
链接系统库或第三方库时，路径和名称别混淆
常见错误：把 /usr/lib/libz.so 直接写进 target_link_libraries(myapp /usr/lib/libz.so) —— 这会让 CMake 生成带绝对路径的链接命令，在不同机器上失效；更糟的是，如果该 .so 没有 SONAME，链接器可能忽略路径、只认 -lz，导致找不到符号。
- 优先用
find_package(ZLIB REQUIRED)+target_link_libraries(myapp PRIVATE ${ZLIB_LIBRARIES}) - 若必须用绝对路径，写成
target_link_libraries(myapp PRIVATE /usr/lib/libz.so)，但要确认构建机和部署机路径一致 - 链接
log这类 Android NDK 系统库时，用find_library(log-lib log)后再传给target_link_libraries，避免硬编码
静态库循环依赖时 target_link_libraries 会静默失败
两个 STATIC 库互相 PUBLIC 链接（A → B 且 B → A），CMake 不报语法错，但最终链接 myapp 时可能提示 undefined reference —— 因为链接器按顺序提取静态归档，闭环导致符号无法解析。
- 不要写
target_link_libraries(A PUBLIC B)和target_link_libraries(B PUBLIC A) - 拆出第三个库
common，把双方共用的符号移到里面，再让A和B都PUBLIC链common - 改用
SHARED库可绕过此限制（运行时符号解析），但要注意 ABI 兼容性和加载顺序
最容易被忽略的一点：作用域（PRIVATE/PUBLIC/INTERFACE）不是可选修饰，而是决定依赖是否传递的开关。写错一个字，下游目标就可能编译不过——它不报错，只悄悄漏掉头文件或链接项。
