RPATH是ELF二进制中嵌入的运行时库搜索路径，由动态链接器按序查找依赖的.so；CMake默认不自动设置，因跨平台路径易失效且可能污染部署环境，需显式配置BUILD_RPATH或INSTALL_RPATH并推荐使用$ORIGIN确保可移植性。
什么是RPATH，为什么CMake默认不帮你设好
RPATH是ELF二进制中嵌入的一组运行时库搜索路径，Linux加载器（ld-linux.so）会按此路径查找依赖的.so。CMake默认**不自动写RPATH**，因为跨平台构建时路径易失效，且可能污染部署环境。你得显式告诉它：“这些路径我要打进二进制里”。
常见现象：./myapp: error while loading shared libraries: libfoo.so: cannot open shared object file，但ldd ./myapp明明显示依赖存在——说明编译链接成功了，只是运行时找不到。
关键点：RPATH只影响**当前目标**（可执行文件或共享库），不影响其依赖的依赖；它和LD_LIBRARY_PATH是两套机制，前者更可靠、不依赖环境变量。
用set_target_properties手动设置RPATH
最直接可控的方式，适用于单个可执行文件或库：
- 在
add_executable(myapp main.cpp)之后加：
set_target_properties(myapp PROPERTIES INSTALL_RPATH "$ORIGIN/../lib:$ORIGIN/lib")set_target_properties(myapp PROPERTIES BUILD_RPATH "$ORIGIN/../lib:$ORIGIN/lib")
add_executable(myapp main.cpp)之后加：set_target_properties(myapp PROPERTIES INSTALL_RPATH "$ORIGIN/../lib:$ORIGIN/lib")set_target_properties(myapp PROPERTIES BUILD_RPATH "$ORIGIN/../lib:$ORIGIN/lib")$ORIGIN是运行时占位符，代表当前二进制所在目录（不是构建目录！）。多个路径用:分隔。注意：BUILD_RPATH用于开发阶段（make后直接运行），INSTALL_RPATH用于make install后安装的二进制。
别写绝对路径（如/home/user/build/lib），否则部署到其他机器就失效；也别漏掉$ORIGIN——写成lib会被当相对路径解析失败。
用CMAKE_INSTALL_RPATH全局配置所有目标
适合项目统一管理，尤其含多个可执行文件时：
- 在
project(...)之后立即加：
set(CMAKE_INSTALL_RPATH "$ORIGIN/lib:$ORIGIN/../lib")- 并确保启用RPATH生成：
set(CMAKE_SKIP_RPATH FALSE)
project(...)之后立即加：set(CMAKE_INSTALL_RPATH "$ORIGIN/lib:$ORIGIN/../lib")set(CMAKE_SKIP_RPATH FALSE)
这样所有后续add_executable/add_library都会继承该RPATH。但注意：CMAKE_INSTALL_RPATH只影响INSTALL_RPATH，不影响BUILD_RPATH；开发时仍需单独设BUILD_RPATH或用CMAKE_BUILD_RPATH（CMake 3.14+）。
兼容性提示：CMake 3.10以下不支持CMAKE_BUILD_RPATH，老项目建议坚持用set_target_properties逐个配。
验证RPATH是否生效，以及常见陷阱
编译后立刻检查，别等部署失败才回头找：
- 查RPATH字段：
readelf -d ./myapp | grep RPATH，应看到类似0x000000000000001d (RPATH) Library rpath: [$ORIGIN/lib] - 查实际解析路径：
patchelf --print-rpath ./myapp（需装patchelf） - 运行前模拟加载：
LD_DEBUG=libs ./myapp 2>&1 | grep "trying"，看是否尝试了$ORIGIN/lib下的路径
容易踩的坑：
-
$ORIGIN必须小写，写成$origin或$ORIGIn无效 - 路径末尾不加
/（$ORIGIN/lib/是错的），$ORIGIN本身已代表目录 - 如果目标链接了系统库（如
libstdc++.so），它们不受RPATH影响，但你的私有.so必须能被找到 - macOS用
RUNPATH和@loader_path，不是RPATH——这个方案仅限Linux
C++项目里RPATH不是“设了就完事”，它和你的目录结构强绑定。$ORIGIN看着简单，但一旦二进制被挪动位置、或通过符号链接调用，行为就会变。上线前务必在干净环境（比如Docker容器）里测试真实路径解析。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
