现代cmake推荐用target_include_directories和target_link_libraries替代全局的include_directories与link_directories，以实现作用域精确、传播可控和安装友好；路径宜用相对路径，库名需去除lib前缀和后缀，且依赖顺序须右→左；修改后须手动重载cmake项目。
CLion 里加库不是点几下就能完的事，关键得让 CMakeLists.txt 真正告诉链接器“去哪找头文件、去哪找 .so 或 .a、连哪些符号”。光在 IDE 里点“添加库”没用，CLion 不会自动改 CMake 配置。
怎么写 include_directories 和 link_directories
这两条命令负责“告诉编译器和链接器路径”，但容易误用：
-
include_directories只影响头文件搜索路径（#include <xxx></xxx>或#include "xxx.h"），不参与链接 -
link_directories只影响链接阶段的库搜索路径，但不会自动把库加进目标；它只是“备选目录”，真正要连还得靠target_link_libraries - 路径尽量用相对路径（如
${CMAKE_SOURCE_DIR}/lib），避免硬编码绝对路径，否则换机器就炸 - 如果库头文件在
./include/acl/redis.h，那就写include_directories(${CMAKE_SOURCE_DIR}/include)，而不是include_directories(${CMAKE_SOURCE_DIR}/include/acl)—— 否则#include <acl></acl>才能命中
target_link_libraries 怎么填库名才对
这是最容易出错的一环：传给 target_link_libraries 的名字 ≠ 文件名。
- 对于
libnet.so或libnet.a，只写net（去掉lib前缀和.so/.a后缀） - 对于
libacl_cpp.a，写acl_cpp；对于pthread，直接写pthread（系统库，不用路径） - 顺序重要：被依赖的库放右边，依赖它的放左边。比如你的代码用了
lib_acl_cpp.a，而它又依赖lib_acl.a，就得写成target_link_libraries(MyApp acl_cpp acl) - 如果库是全路径（比如
/usr/local/lib/libzstd.so），可以直接传完整路径进去，绕过link_directories
动态库 .so 运行时找不到怎么办
CMake 能帮你编译通过，但运行时报 error while loading shared libraries: libxxx.so: cannot open shared object file，说明系统 loader 找不到它。
- 临时解决：运行前执行
export LD_LIBRARY_PATH=/path/to/your/lib:$LD_LIBRARY_PATH - 长期方案：在
target_link_libraries后加一行set_target_properties(MyApp PROPERTIES INSTALL_RPATH "$ORIGIN/../lib")，让可执行文件记住相对路径 - 或者用
patchelf --set-rpath '$ORIGIN/../lib' ./MyApp（Linux）手动打补丁，适合发布前 - 注意：
$ORIGIN是 loader 识别的特殊 token，不能写成.或./lib
最常被忽略的是：CMake 配置改了之后，CLion 不会自动 reload，必须右键 CMakeLists.txt → “Reload CMake project”，否则所有改动都白写。另外，link_directories 对现代 CMake（3.10+）已不推荐，更稳妥的方式是用 find_library 或导入 IMPORTED 目标，但对简单项目，上面三步够用。
