正确做法是用find_library()查找系统库再链接：find_library(zlib_libraries names z zlib required)，然后target_link_libraries(myapp ${zlib_libraries})；禁用裸-l语法和绝对路径，确保跨平台可移植性，并注意linux运行时库路径、windows导入库与dll分离、以及find_library默认不搜/usr/lib需加hints等关键细节。
怎么在CMakeLists.txt里正确找到并链接系统动态库
直接写 target_link_libraries(myapp -lfoo) 是错的，CMake不认这种裸 -l 语法；也不能硬写绝对路径（比如 /usr/lib/x86_64-linux-gnu/libz.so），会破坏跨平台和可移植性。
正确做法是用 find_library() 找库，再传给 target_link_libraries()：
find_library(ZLIB_LIBRARIES NAMES z zlib REQUIRED)
target_link_libraries(myapp ${ZLIB_LIBRARIES})
关键点：
-
NAMES列出可能的库名（z和zlib都常见，不同发行版/编译环境习惯不同） -
REQUIRED让 CMake 在找不到时报错，避免静默链接失败 - 不要用
find_package(ZLIB REQUIRED)后直接target_link_libraries(myapp ZLIB::ZLIB)—— 这只对支持现代 CMake 导出目标的包才可靠，系统自带的.so往往没这层封装
Linux 上链接 .so 但运行时报 “library not found” 怎么办
编译通过 ≠ 运行成功。CMake 只管编译期链接，不管运行时动态加载器（ld.so）能不能找到 .so。
常见原因和对策：
- 库在非标准路径（如
/usr/local/lib或/opt/mylib/lib）：编译时加set(CMAKE_INSTALL_RPATH "$ORIGIN/../lib:/usr/local/lib")，或运行前设LD_LIBRARY_PATH - 使用
find_library()找到的是libfoo.so，但实际需要的是带 soname 的版本（如libfoo.so.1）：确保系统已安装对应开发包（如 Ubuntu 的libfoo1-dev，而非仅libfoo1） -
target_link_libraries()没传PRIVATE/PUBLIC修饰符，导致下游 target 无法继承链接关系：显式写成target_link_libraries(myapp PRIVATE ${ZLIB_LIBRARIES})
Windows 上链接 .dll 的实际约束比想象中多
Windows 下 CMake 链接 .dll 本质是链接对应 .lib 导入库（import library），不是直接连 .dll 文件本身。
所以你真正要找的是 .lib，不是 .dll：
find_library(WINMM_LIBRARIES NAMES winmm REQUIRED)
target_link_libraries(myapp ${WINMM_LIBRARIES})
注意：
- 系统 DLL（如
winmm.dll、ws2_32.dll）的.lib通常随 MSVC/MinGW 自带，find_library()能直接命中 - 第三方 DLL（如
libcurl.dll）必须提供配套libcurl.lib（或libcurl.a），且路径要进CMAKE_PREFIX_PATH或显式用HINTS - 运行时仍需把
.dll放到可执行目录、PATH或系统目录下，否则报错The code execution cannot proceed because xxx.dll was not found.
为什么有时候 find_library 找不到 /usr/lib 下的 .so
默认情况下，find_library() 不查 /usr/lib，尤其在非 root 用户或交叉编译时。它优先查 CMAKE_PREFIX_PATH、CMAKE_SYSTEM_PREFIX_PATH，而这些路径在 Linux 发行版中常被设为 /usr，但具体子路径策略依赖 CMake 版本和构建类型。
稳妥做法：
- 显式加
HINTS /usr/lib /usr/lib64 /lib /lib64 - 或设
set(CMAKE_LIBRARY_PATH "/usr/lib;/usr/lib64")（注意这是变量，不是命令） - 检查是否用了
find_library(... PATHS ...)错误覆盖了默认搜索路径 ——PATHS是精确匹配，HINTS是追加 - 用
cmake -DCMAKE_VERBOSE_MAKEFILE=ON编译，看日志里实际搜了哪些路径
系统库路径逻辑比表面复杂，别假设“它应该能找到”，每次链接前最好用 find_library(... REQUIRED NO_CACHE) 强制刷新并验证结果。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
